How to Get Decisions by ID - Shovels Documentation

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"

Parameter	Description
`id`	One 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.

How to Search for Decisions Where Decisions Are Available

⌘I