API referenceBatch
Get per-photo batch results
Authoritative pull fallback for every photo in a batch. (GET /v1/batches/{id}/photos)
Last updated
GET
/v1/batches/{id}/photos- Auth
- Bearer API key
- Billing
- free (0 credits).
Authoritative pull fallback for every photo in a batch. Results are
keyset-paginated by zero-based photo_index; use next_after_index
while has_more=true. For an op=match batch each succeeded photo also
carries its match result (matches, photo_ids, and reason when set),
the same data the webhook sends, so a webhook is not required. Free.
Example request
curl -X GET "https://api.sightradar.com/v1/batches/$ID/photos" \
-H "Authorization: Bearer $SR_API_KEY"Put each id in the path percent-encoded, as a single path segment. An id with /, ?, #, % or a space otherwise addresses a different URL. In code, use your HTTP library's path encoding (for example encodeURIComponent in JavaScript or urllib.parse.quote(id, safe="") in Python).
Parameters
| Name | In | Type | Description |
|---|---|---|---|
id required | path | string | |
limit | query | integer | Page size. For an op=match batch the default and maximum are 100, because each row carries its match list. |
after_index | query | integer |
Response body
| Field | Type | Description |
|---|---|---|
batch_id | string | |
collection_id | string | |
status | string | |
total_photos | integer | |
photos | object[] | |
has_more | boolean | |
next_after_index | integer |
Status codes
| Status | Meaning |
|---|---|
200 | Per-photo batch outcomes. |
401 | Missing or invalid API key. |
404 | Resource not found. |