Skip to main content
GET
Retrieve an egocentric job
Poll this endpoint until status is completed or failed. Treat any future, unknown status as unfinished. A job can remain unfinished after execution ends while its result and billing are finalized. For failed jobs, inspect error.fault and error.retryable; the retry flag does not start another execution. See job failures and retry guidance. For authentication, limits, and HTTP errors, see the workflow and error guide.

Authorizations

Authorization
string
header
required

Bearer token authentication using your Perceptron API key

Path Parameters

job_id
string
required

Job identifier.

Response

Job

State, input attributes, timing, and failure information for one video.

batch_id
string
required

Identifier of the batch containing this job.

created_at
string<date-time>
required

UTC time the job's batch was accepted.

error
null | object
required

Failure information when status is failed; null otherwise.

execution_finished_at
string<date-time> | null
required

Actual execution end; null if the job never ran or the time is unknown.

expires_at
string<date-time> | null
required

Result retention expiry, 30 days after finished_at; null until the job finishes.

finished_at
string<date-time> | null
required

Time result storage and usage settlement finished; null until the job is final.

id
string
required

Unique job identifier.

input_metadata
object
required

Video attributes; each unknown attribute is null.

object
string
required

Object type, always egocentric.job.

Example:

"egocentric.job"

started_at
string<date-time> | null
required

Actual execution start; null if the job never ran or the time is unknown.

status
enum<string>
required

Current public state; completed and failed are final.

Available options:
queued,
submitted,
processing,
completed,
failed