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

<ParamField path="job_id" type="string" required>The ID returned at submission.</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/job-status/JOB_ID \
  -H "Authorization: Key YOUR_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.