Resources
Get jobs
Read several jobs at once by id, in the same shape Create jobs answers with. Poll this while a request is still rendering.
GET /api/jobsRequires batches:read.
| Name | Type | Required | Description |
|---|---|---|---|
workspace | string | Yes | Workspace slug or id. |
ids | string | Yes | Job ids separated by commas, 1 to 10. |
curl "https://app.kalpana.one/api/jobs?workspace=acme&ids=7b0c2d1e-4f5a-4c8b-9e3d-2a6f1b8c0d11,c19e5a44-8d70-4b2f-b6a1-3e7d9f0a2c58" \
--header "x-api-key: $KALPANA_API_KEY"This is the URL a 202 from Create jobs points to in its Location header, so you can follow it as it is.
Response
{
"status": "processing",
"jobs": [
{
"id": "7b0c2d1e-4f5a-4c8b-9e3d-2a6f1b8c0d11",
"status": "success",
"template": { "id": "t4hz8c1n", "name": "Weekend sale" },
"page": { "id": "k7fq2m8a", "name": "Feed" },
"flow": null,
"batch": null,
"modifications": { "Headline": "Weekend offer" },
"output": { "format": "png", "kind": "image" },
"creditCost": 1,
"error": null,
"file": {
"creativeId": "5d3a9c70-1e2b-4f86-a7c4-90b1d2e3f4a5",
"url": "https://cdn.kalpana.one/...",
"fileName": "weekend-sale-feed.png",
"contentType": "image/png",
"sizeBytes": 284113,
"width": 1080,
"height": 1080
},
"createdAt": "2026-11-09T09:41:07.512Z",
"updatedAt": "2026-11-09T09:41:11.208Z"
},
{
"id": "3f6a1c9e-2b84-4d07-a5e1-7c0d8b9a4f12",
"status": "processing",
"template": { "id": "t4hz8c1n", "name": "Weekend sale" },
"page": null,
"flow": { "id": "f2dm6x9r", "name": "Launch video" },
"batch": null,
"modifications": { "Price": "₹499" },
"output": { "format": "mp4", "kind": "video" },
"creditCost": 5,
"error": null,
"file": null,
"createdAt": "2026-11-09T09:41:07.512Z",
"updatedAt": "2026-11-09T09:41:07.901Z"
}
]
}The request status is processing while any job renders, pending while any waits to be run, and done once every job is success, failed or cancelled. The jobs come back in the order of ids. An id that is not a job of this workspace is left out rather than refused, so compare the count if you need every one. See The job object.
This answers with 200 and does not wait. Poll every few seconds, as Retry-After suggests.
To page through the jobs of a batch, use List a batch's jobs.
Errors
| Status | Cause |
|---|---|
400 | ids is missing, empty, or names more than 10 jobs. |
403 | Your role or key lacks batches:read. |
Was this page helpful?
Updated 9 Nov 2026