API reference / Devices, signing & primitives / Get job

Get job

A job’s progress and results.

GETapi.tikultra.com/v1/jobs/{id}Free
Upstream
gateway · async batch queue
Access
Every plan
Runs on
Primitive
Billing
Failed calls are free

Authorization & parameters

x-api-keyheader · stringrequired

Your API key. Create one in API keys.

Path parameters

idstringrequired

The job ID. For example job_8fK2xQ9mP4.

Client and egress

Runs locally on the protocol primitive layer with deterministic codec / cryptographic state. See Devices, signing & primitives.

Response

A 200 returns JSON with stable field names. Every response carries x-credits-cost, x-credits-tier and x-credits-remaining.

Response fields

Key top-level and nested fields decoded from the mobile upstream payload:

idstring

Decoded id value.

statusstring

Current lifecycle or health status.

tasks_totalinteger

Decoded tasks total value.

tasks_doneinteger

Decoded tasks done value.

tasks_failedinteger

Decoded tasks failed value.

credits_chargedinteger

Decoded credits charged value.

resultsobject[]

List of results objects.

results[].indexinteger

Decoded index value.

results[].pathstring

Decoded path value.

results[].statusinteger

Current lifecycle or health status.

results[].creditsinteger

Decoded credits value.

results[].dataobject

Structured data metadata.

Errors

Errors return a JSON body with a stable code and cost 0 credits. See Errors and retries.