> ## 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.

Configure your [deployment URL and API key](/reference/authentication) before
using the examples below.

<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 --fail-with-body "${SUTRO_API_URL%/}/v1/jobs/JOB_ID" \
  -H "Authorization: Key $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": "..." }`.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.