Read the current state of a job

{
  "completed_at": "2026-09-24T10:00:12Z",
  "created_at": "2026-09-24T10:00:05Z",
  "error": null,
  "expires_at": "2026-09-25T10:00:05Z",
  "id": "job_4ryn2an9hm2qxnb6xvbrav094b",
  "inputs": [
    {
      "asset_id": "asset_6pa8ad0ds2t7g1z6pg4tcr4zqp",
      "role": "source"
    }
  ],
  "operation": "skin.analyze",
  "output": {
    "type": "skin.analysis",
    "concerns": [
      {
        "concern": "acne",
        "score": 8.7,
        "status": "measured",
        "unavailable_reason": null
      },
      {
        "concern": "redness",
        "score": 7.4,
        "status": "measured",
        "unavailable_reason": null
      },
      {
        "concern": "wrinkles",
        "score": null,
        "status": "unavailable",
        "unavailable_reason": "not_measured"
      }
    ],
    "analysis_version": "skin-2026-09-draft.1",
    "visualizations": [
      {
        "expires_at": "2026-09-25T10:00:05Z",
        "href": "/v1/assets/asset_cnep5j6sw0kphca1v6gv6qwayc/content",
        "id": "asset_cnep5j6sw0kphca1v6gv6qwayc",
        "media_type": "image/png",
        "role": "mask.acne",
        "size_bytes": 55312,
        "height": 1600,
        "width": 1200
      }
    ]
  },
  "status": "succeeded",
  "updated_at": "2026-09-24T10:00:12Z"
}

Returns the current state of a job owned by the calling environment. This is the single polling surface for every product operation.

Honour Retry-After while the job is queued or running, and send the previous ETag back as If-None-Match to get 304 Not Modified instead of an unchanged body. A 404 means the job never existed in this environment or its retention window has passed; a 503 means ask again.

Authentication

X-API-Keystring

API key for one environment of your account. Keep server-side; never expose in browser clients.

Path parameters

job_idstringRequired

Response headers

Cache-ControlstringOptional

API responses are private to the caller and not cacheable

ETagstringOptional

Opaque version of the current job representation

Retry-AfterstringOptional

Delay before retrying, expressed as delta-seconds

X-Request-IdstringOptional

Request correlation identifier

Response

Current job state

completed_atdatetime or null

created_atdatetime

errorobject or null

expires_atdatetime or null

idstring

inputslist of objects

operationenum

What a job does: the operation’s authorization scope.

An operation is not its output’s type: OPERATION_OUTPUT_TYPE is the one place the two meet.

Allowed values:

outputobject or null

statusenum

Allowed values:

updated_atdatetime

livemodebooleanOptional

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

503

Service Unavailable Error

Authentication

Path parameters

Headers

Response headers

Response

Errors