---
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}`

## Request

- Base URL: `https://www.forter.com`
- URL: `https://www.forter.com/batch/jobs/{job_id}`
- Auth: none required
- TypeScript: <https://skmtc.dev/forter/apis/forter-api/docs/batch/jobs/:job_id/get.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/forter/apis/forter-api.md) - [All operations](https://skmtc.dev/forter/apis/forter-api/llms.txt) - [OpenAPI document](https://skmtc.dev/forter/apis/forter-api/revisions/d7b02e919b34?raw)