# Jobs

> Retrieve Raywake generation status and output links, or filter your job history by model, date, status and source through the API.

Canonical: https://raywake.si/docs/reference/jobs
Last updated: 2026-10-13

## Get a job

`GET /v1/jobs/{job_id}`

Requires `jobs:read`. Only jobs of the key's account are visible.

**Example**

cURL:

```bash
curl -s https://api.raywake.com/v1/jobs/JOB_ID \
  -H "Authorization: Bearer $RAYWAKE_API_KEY"
```

Python:

```python
import json, os, requests

response = requests.get(
    "https://api.raywake.com/v1/jobs/JOB_ID",
    headers={"Authorization": f"Bearer {os.environ['RAYWAKE_API_KEY']}"},
)
print(response.json())
```

JavaScript:

```javascript
const response = await fetch("https://api.raywake.com/v1/jobs/JOB_ID", {
  method: "GET",
  headers: { Authorization: `Bearer ${process.env.RAYWAKE_API_KEY}` },
});
console.log(await response.json());
```

**Job fields**

| Name | Type | Description |
| --- | --- | --- |
| `job_id` | string | Identifier for polling and support requests. |
| `status` | string | Lifecycle state. See [Generations](https://raywake.si/docs/generations). |
| `model` | string | The model id the generation ran on. |
| `prompt` | string | The prompt, when the model takes one. |
| `input` | object | The input you submitted, as sent (model defaults are not filled in). |
| `outputs` | array | Results: `type` (`image`, `video`, `audio`), `url`, `mime_type` and an optional `thumbnail_url`. Empty until the result is stored. |
| `image_url` | string \| null | The first image output, for convenience. |
| `error` | string \| null | A readable reason when the generation did not produce a result. |
| `quote_id` | string \| null | The quote the generation was admitted with. |
| `reserved_usd` | string \| null | Quoted USD amount held while running; released on failure. |
| `charged_usd` | string \| null | Final amount charged in USD, or null until settlement. |
| `source` | string | `api` when an API key started the job, otherwise `studio`. |
| `api_key_id` | string \| null | The API key that started the job. |
| `created_at` | string | ISO 8601 timestamp, UTC. |
| `completed_at` | string \| null | ISO 8601 timestamp, UTC, once terminal. |

## List jobs

`GET /v1/jobs`

**Query parameters**

| Name | Type | Description |
| --- | --- | --- |
| `status` | string | Only jobs in this status. |
| `model` | string | Only jobs on this model id. |
| `since` | string | ISO 8601 time; only jobs created at or after it. |
| `until` | string | ISO 8601 time; only jobs created before it. |
| `source` | string | Where jobs were started. Options: `api`, `studio`. |
| `api_key_id` | string | Only jobs started with this API key. |
| `limit` | integer | Page size, up to 500. Default: `50`. |
| `offset` | integer | Items to skip. Default: `0`. |

## Related

- [API documentation](https://raywake.si/docs)
