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

# Get job status

> Retrieves the current status and results of an asynchronous job. Poll this endpoint to track job progress and retrieve results when complete…

Retrieves the current status and results of an asynchronous job.
Poll this endpoint to track job progress and retrieve results when complete.
**Example**

```bash theme={null}
curl -X GET 'https://api.nsr.stateset.com/api/v1/jobs/job_0000000000000042' \
-H 'X-API-Key: your-api-key'
```

**Required scope:** `read`

### Path parameters

<ParamField path="job_id" type="string" required>
  Unique job identifier returned from job submission
</ParamField>

### Response

`JobStatusResponse`

<ResponseField name="job" type="Job" required>
  <Expandable title="Job">
    <ResponseField name="completed_at" type="integer (int64)">
      Completion timestamp (Unix ms, if completed)
    </ResponseField>

    <ResponseField name="created_at" type="integer (int64)" required>
      Creation timestamp (Unix ms)
    </ResponseField>

    <ResponseField name="error" type="string">
      Error message if failed
    </ResponseField>

    <ResponseField name="id" type="string" required>
      Unique job identifier
    </ResponseField>

    <ResponseField name="input" type="object" required>
      Input parameters
    </ResponseField>

    <ResponseField name="job_type" type="JobType" required />

    <ResponseField name="progress" type="integer (int32)" required>
      Progress percentage (0-100)
    </ResponseField>

    <ResponseField name="result" type="object">
      Result data (JSON)
    </ResponseField>

    <ResponseField name="status" type="JobStatus" required />

    <ResponseField name="updated_at" type="integer (int64)" required>
      Last update timestamp (Unix ms)
    </ResponseField>
  </Expandable>
</ResponseField>

### Status codes

| Code  | Meaning                                            |
| ----- | -------------------------------------------------- |
| `200` | Job status and results                             |
| `401` | Unauthorized — missing or invalid credentials      |
| `403` | Forbidden — the key/token lacks the required scope |
| `404` | Job not found                                      |
| `429` | Rate limited — see Retry-After / X-RateLimit-Reset |

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://api.nsr.stateset.com/api/v1/jobs/{job_id}' \
    --header 'X-API-Key: YOUR_API_KEY'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "job": {
      "completed_at": 1,
      "created_at": 1,
      "error": "string",
      "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "input": null,
      "job_type": "batch_infer",
      "progress": 1,
      "result": null,
      "status": "pending",
      "updated_at": 1
    }
  }
  ```
</ResponseExample>