Skip to main content
POST
Compare two ECU binaries

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
reference_file_id
string<uuid>
required

Opaque account-owned identifier.

comparison_file_id
string<uuid>
required

Opaque account-owned identifier.

limit
integer
default:20
Required range: 1 <= x <= 200

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