API Reference

Photos

List evaluated photos and related protocol metadata for a store and time range.

GET
/v1/stores/{externalId}/photos

Returns photos captured for the store in the requested time range. Use filters to narrow by protocol, exposition, image status, or protocol status.

Authorization

bearerAuth
AuthorizationBearer <token>

In: header

Path Parameters

externalId*string

Store identifier from your system. This is the public store key used in API paths.

Query Parameters

from*string

Inclusive start of the requested date-time range.

to*string

Exclusive end of the requested date-time range.

limit?integer

Maximum number of photos to return. The default is 100 and the maximum is 500.

status?string

Protocol status filter.

status?string

Image processing status filter.

protocolId?string
expositionId?string
cursor?string

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/v1/stores/store-123/photos?from=2026-06-15T00%3A00%3A00Z&to=2026-06-16T00%3A00%3A00Z&limit=100&status=completed"
{}
{  "error": {    "code": "not_configured",    "message": "string",    "issues": [      {        "path": "string",        "message": "string",        "code": "string"      }    ]  }}
{  "error": {    "code": "not_configured",    "message": "string",    "issues": [      {        "path": "string",        "message": "string",        "code": "string"      }    ]  }}