> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sutro.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Fetch a job

> Retrieve one Batch job and its metadata.

<ParamField path="job_id" type="string" required>The job to retrieve.</ParamField>

## Headers

<ParamField header="Authorization" type="string" required>
  Deployment API key in the form `Key YOUR_SUTRO_API_KEY`.
</ParamField>

```bash theme={null}
curl https://YOUR-SUTRO-DEPLOYMENT/v1/jobs/JOB_ID \
  -H "Authorization: Key YOUR_SUTRO_API_KEY"
```

## Response

The response is `{ "job": { ... } }`. A job contains:

| Field                                                        | Type            | Meaning                                |
| ------------------------------------------------------------ | --------------- | -------------------------------------- |
| `job_id`, `status`, `model`                                  | string          | Identity, state, and model or Function |
| `system_prompt`                                              | string \| null  | Standalone-model prompt                |
| `job_priority`                                               | integer         | `0` or `1`                             |
| `datetime_created`, `datetime_started`, `datetime_completed` | string \| null  | ISO timestamps                         |
| `json_schema`                                                | object \| null  | Structured-output schema               |
| `sampling_params`                                            | object          | Generation settings                    |
| `name`, `description`                                        | string \| null  | User metadata                          |
| `input_tokens`, `output_tokens`, `num_rows`                  | integer \| null | Usage totals                           |
| `job_cost`, `cost_estimate`                                  | number \| null  | Actual or estimated USD cost           |
| `failure_reason`                                             | object \| null  | Failure detail                         |

Fields that depend on execution remain `null` until available. A missing job returns `404` with `{ "message": "..." }`.