Get async segmentation job status

Return the current job status and per-task state. This response does not include masks. Poll until status is success or failed, then call retrieveJobResult or createJobDownload.

Authentication

AuthorizationBearer

Unrestricted secret sk_live_... or Cognito access token in Authorization: Bearer ...

Path parameters

jobIdstringRequired

Async job identifier.

Response

Current async job status

jobIdstring

typeenum

processingModeenum

statusenum

totalItemsinteger>=1

createdAtdatetime

updatedAtdatetime

taskslist of objects

Per-task results for the job

errorstring or nullOptional

Errors

401

Unauthorized Error

404

Not Found Error

500

Internal Server Error

1	import { SegmentationAPIClient } from "@segmentationapi/sdk";
2
3	async function main() {
4	const client = new SegmentationAPIClient({
5	token: "YOUR_TOKEN_HERE",
6	});
7	await client.jobs.retrieveJob({
8	jobId: "jobId",
9	});
10	}
11	main();

1	{
2	"jobId": "job-abc-987",
3	"type": "image",
4	"processingMode": "batch",
5	"status": "processing",
6	"totalItems": 2,
7	"createdAt": "2026-08-03T12:00:00Z",
8	"updatedAt": "2026-08-03T12:01:00Z",
9	"tasks": [
10	{
11	"taskId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890.png",
12	"status": "processing"
13	},
14	{
15	"taskId": "b2c3d4e5-f6a7-8901-bcde-f12345678901.jpg",
16	"status": "success"
17	}
18	]
19	}