---
title: Get a job
description: The full job record.
---
`GET` `/v1/jobs/{id}`

**Host** `https://api.open.sume.com` · **Auth** API key

Returns the whole job: its model, the inputs it ran with (`input`), timestamps, result, error and webhook delivery.

## Request

### Headers

| Header | Type | Required | Description |
|---|---|---|---|
| `Authorization` | string | Yes | `Bearer <key>`. Or send `x-api-key`. |

### Path

| Name | Type | Required | Description |
|---|---|---|---|
| `id` | string | Yes | The job id (`job_...`) from the submit response. |

## Example

<!-- api-call-example:v2-job-get -->

## Response

`200 OK`

```json
{
  "data": {
    "job": {
      "id": "job_ac70a9f7-5a6d-4432-9bb1-44ff9f0c3659",
      "type": "image_generation",
      "status": "completed",
      "model": "gpt-image-2",
      "idempotency_key": "oas-stress-de31d5e8-d38f-47be-ad21-bea70256d8a5",
      "communication_mode": "async",
      "created_at": "2026-10-14T22:41:08.786Z",
      "updated_at": "2026-10-14T22:41:20.531Z",
      "started_at": "2026-10-14T22:41:09.308Z",
      "completed_at": "2026-10-14T22:41:20.531Z",
      "canceled_at": null,
      "auth_source": "api_key",
      "result": {
        "artifacts": [
          {
            "id": "artf_cIxQ4jmJfjRZGIsWWJ21WmPAbUJE_CJP",
            "type": "image",
            "url": "https://media.sume.com/artifacts/artf_cIxQ4jmJfjRZGIsWWJ21WmPAbUJE_CJP/images.png",
            "content_type": "image/png",
            "public_artifact_id": "artf_cIxQ4jmJfjRZGIsWWJ21WmPAbUJE_CJP",
            "visibility": "public_by_link",
            "size_bytes": null,
            "width": null,
            "height": null,
            "duration_ms": null,
            "checksum_sha256": null
          }
        ]
      },
      "error": null,
      "webhook_delivery": null,
      "input": {
        "prompt": "open-api-split idempotency probe: one red cube",
        "quality": "low",
        "num_images": 1
      }
    }
  }
}
```

## Errors

| Status | `code` | When |
|---|---|---|
| 401 | `unauthorized` | No key, or the key is wrong or revoked. |
| 404 | `not_found` | No job with that id in your workspace. |
| 429 | `rate_limited` | Too many requests for your key in this window. |

[All error codes](/docs/errors)

## Related

- [List jobs](/docs/reference/jobs/list)