Skip to main content
POST
Read a map’s cell values

Authorizations

Authorization
string
header
required

All API methods require Bearer authentication. Use your existing API key as the bearer token.

Authorization header format: Authorization: Bearer YOUR_API_KEY.

Headers

Idempotency-Key
string
required

Reuse this key only for retries of the same operation and parameters. Keys are scoped to the account. A retry returns the original job, including after service updates; use a new key to request a fresh analysis.

Required string length: 1 - 128
Pattern: ^[!-~]+$

Body

application/json
file_id
string<uuid>
required

Opaque account-owned identifier.

scan_job_id
string<uuid>
required

Opaque account-owned identifier.

map_id
string
required

Map identifier returned by this file's completed scan or inspection.

Pattern: ^[a-f0-9]{64}$

Response

Accepted background job.

job_id
string<uuid>
required

Opaque account-owned identifier.

operation
enum<string>
required
Available options:
identify,
inspect,
maps,
map-grid,
diff
status
enum<string>
required
Available options:
queued,
running,
completed,
failed,
cancelled,
expired
message
string
required
expires_at
string<date-time> | null
required
created_at
string<date-time>
required
status_url
string
required
result
object

Compact customer report. identify and inspect always include identification and confidence. Other operation-specific sections appear only when relevant. No provider diagnostics, raw confidence scores or internal provenance are exposed. Inspection includes structured health observations, map-filter counts and layout when retained evidence is available. Older saved compact reports can omit these additions; details are serialized from retained evidence.

Example:
error
object