Get batch job

GET /v1/batch/jobs/{job_id}

Returns status, timestamps, and progress counts for one job owned by this API key.

When to use it

Use this endpoint for job polling and job detail pages.

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
`job_id`	path	Yes	Batch job id returned by `POST /v1/batch/jobs`.
`api_key`	query	No	Optional alternative to the `X-API-Key` header. Prefer the header for server-side applications.

Response

Returns one batch job status record.

Show Schema

Successful Responseapplication/json

{
  "created_at": 1709230500,
  "display_name": "portfolio_batch.jsonl",
  "id": "batch_a1b2c3d4e5f6g7h8",
  "in_progress_at": 1709230505,
  "metadata": {
    "user_id": "usr_123"
  },
  "object": "batch",
  "request_counts": {
    "completed": 2,
    "failed": 0,
    "total": 5
  },
  "status": "in_progress"
}

Request pattern

curl "https://developers.manasija.in/v1/batch/jobs/batch_a1b2c3d4e5f67890" \
  -H "X-API-Key: $DRISHTI_API_KEY"

JavaScript / TypeScript SDK

const job = await client.getBatchJobsJobId({ job_id: "batch_a1b2c3d4e5f67890" })

Python SDK

job = client.get_batch_jobs_job_id(job_id="batch_a1b2c3d4e5f67890")

Interactive reference

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