Skip to main content
When you already know which decisions you want, use the Get Decisions By ID endpoint to fetch them directly—no date range or geo_id required.

​
Request

Pass one or more decision IDs in the id parameter: 
curl -X GET \
  "https://api.shovels.ai/v2/decisions?id=DECISION_ID_1&id=DECISION_ID_2" \
  -H "X-API-Key: YOUR_API_KEY_HERE"
ParameterDescription
idOne or more decision IDs. Up to 50 IDs per request.

​
Behavior

  • Unknown IDs are silently omitted—you won’t get a per-ID 404. If you request 50 IDs and only 48 exist, the response contains 48 decisions.
  • The response uses the same paginated envelope and decision fields as the search endpoint.
Decision IDs come from the Search Decisions endpoint. Store the id field from search results to look records up again later.