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

# Check job status

> Read the current state of a Batch job.

Configure your [deployment URL and API key](https://docs.sutro.sh/reference/authentication.md) before
using the examples below.

**job\_id** `string` *required*

The ID returned at submission.

## Headers

**Authorization** `string` *required*

Deployment API key in the form `Key YOUR_SUTRO_API_KEY`.

```bash theme={null}
curl --fail-with-body "${SUTRO_API_URL%/}/v1/job-status/JOB_ID" \
  -H "Authorization: Key $SUTRO_API_KEY"
```

```json theme={null}
{
  "message": "Job status with job_id JOB_ID retrieved.",
  "job_status": {
    "JOB_ID": "RUNNING"
  },
  "metadata": null
}
```

Read the status from `job_status["JOB_ID"]`. Its value is `QUEUED`,
`STARTING`, `RUNNING`, `SUCCEEDED`, `CANCELLING`, `CANCELLED`, `FAILED`, or
`UNKNOWN`.

`metadata` is normally `null`. For a failed job, it contains a
`failure_reason` object with the available failure detail.


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