---
title: "DEMO - poll a batch job"
method: GET
path: "/batch/jobs/{job_id}"
tags: ["demo", "batch", "polling"]
---

# DEMO - poll a batch job

`GET /batch/jobs/{job_id}`

Returns the batch job's status and (when completed) per-operation results. Stateless - the job_id is a base64url-encoded JSON spec so the response is recomputable from the id alone.

## Path parameters

- `job_id` string, required

## Response `200`

Job status. `status=pending` within the first second after creation; `status=completed` thereafter with `results[]` populated.

- object
  - `object` 'batch_job', required
  - `job_id` string, required
  - `status` 'pending' | 'completed', required
  - `op_count` integer
  - `elapsed_seconds` integer
  - `results` object[]
  - `ops_pending` object[]
  - `availability` object

## Other responses

- `404` — Not Found (The requested item doesn't exist)

---

[API](https://skmtc.net/forter/apis/forter-api.md) · [All operations](https://skmtc.net/forter/apis/forter-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/forter/forter-api/revisions/d7b02e919b34/schema)
