Skip to main content
GET
Poll video job status + retrieve report

Authorizations

Authorization
string
header
required

API key starting with zt_live_ (production) or zt_test_ (sandbox). Get your key at https://developers.zebratruth.ai

Path Parameters

requestId
string
required

The requestId returned by POST /compliance/check-video

Response

Current status + report (when terminal)

requestId
string
required
tenantId
string
required
status
enum<string>
required

Public 4-state contract. queued + processing mean the worker is in-flight (continue polling). completed + failed are terminal.

Available options:
queued,
processing,
completed,
failed,
unknown
phase
string

Internal worker phase name (e.g. transcribeAudio, analyzeFrames, done). Useful for showing live progress UI. Not part of the stability contract — new phases may be added without notice.

reportStatus
enum<string>

Terminal status of the analysis. Absent until terminal.

Available options:
complete,
insufficient_evidence,
analysis_failed
billingStatus
enum<string>

Reservation lifecycle. Absent until the worker resolves billing.

Available options:
reserved,
committed,
released
workerCompletedAt
string<date-time>
completedAt
string<date-time>
durationMs
integer

Total worker pipeline duration in milliseconds.

error
string

Failure reason. Present when status is failed.

reportBlobPath
string

Path to the persisted report.json in blob storage. Informational — content is inlined in report.

report
object

The contents of the persisted report.json blob, inlined into status responses.

reportFetchFailed
boolean

Present + true when the row is terminal but the report blob could not be fetched (eventually-consistent storage edge). Retry the same endpoint in 1-2 seconds.