# Jobs

One endpoint to check the state of any async resource.

## Endpoints

| Method | Path | Scope | Credits | Description |
|---|---|---|---|---|
| GET | `/v1/jobs/{id}` | any read scope | 0 | Retrieve job state |

## Response

```json
{
  "object": "job",
  "id": "job_7yb0mr3ck9",
  "status": "running",
  "resource": {
    "object": "search",
    "id": "srch_9dm2pq4x1a"
  },
  "progress": {
    "completed": 12,
    "total": 20
  },
  "error": null,
  "created_at": "2026-08-11T09:14:22Z",
  "completed_at": null
}
```

## Polling guidance

Back off: 1s, 2s, 4s, capped at 10s. Do not poll faster than once a second — you will hit
rate-limits before your job finishes. Prefer webhooks for anything that
routinely exceeds 30 seconds.

## Related

job · webhook-endpoints · errors-and-retries