List batch jobs

GET /v1/batch/jobs

List batch jobs submitted by the current API key, newest first, for a dashboard or polling screen that shows recent work.

When to use it

Use this endpoint for batch dashboards and polling screens that show recent work.

Authentication and billing

Requires X-API-Key or api_key.
Credit cost: Free. Non-billable batch control route.
See pricing for plan allowances and full billing details.

Request

This endpoint does not require a request body.

Field	Location	Required	Notes
`limit`	query	No	Maximum jobs to return. Defaults to `20`.
`api_key`	query	No	Optional alternative to the `X-API-Key` header. Prefer the header for server-side applications.

Response

Returns batch job records newest first.

Show Schema

Successful Responseapplication/json

{
  "data": [
    {
      "created_at": 1709230500,
      "display_name": "portfolio_batch.jsonl",
      "id": "batch_a1b2c3d4e5f6g7h8",
      "object": "batch",
      "status": "succeeded"
    }
  ],
  "object": "list"
}

Request pattern

curl -G "https://developers.manasija.in/v1/batch/jobs" \
  -H "X-API-Key: $DRISHTI_API_KEY" \
  --data-urlencode "limit=20"

JavaScript / TypeScript SDK

const jobs = await client.getBatchJobs({ limit: 20 })

Python SDK

jobs = client.get_batch_jobs(limit=20)

Interactive reference

Use the Scalar API client for executable requests, schemas, and the full OpenAPI contract.