---
title: "Get Batch Status"
method: GET
path: "/api/v1/async/batch/{batch_id}"
tags: ["Async Scraping"]
---

# Get Batch Status

`GET /api/v1/async/batch/{batch_id}`

## Request

- Base URL: `https://api.finedata.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.finedata.ai/api/v1/async/batch/{batch_id}`
- Auth: HTTP bearer

Get batch progress. Pass `include_results=true` to get individual job results.

Statuses: `pending`, `processing`, `completed`, `partial` (some failed), `failed` (all failed).

## Path parameters

- `batch_id` string, required

## Query parameters

- `include_results` boolean: Include individual job results

## Headers

- `authorization` string, nullable
- `x-api-key` string, nullable

## Response `200`

Successful Response

- BatchJobStatusResponse: Batch progress and results.
  - `batch_id` string, required: Batch identifier
  - `status` string, required: Overall status: pending, processing, completed, partial, failed
  - `total_jobs` integer, required: Total jobs in batch
  - `completed_jobs` integer, required: Successfully completed jobs
  - `failed_jobs` integer, required: Failed jobs
  - `created_at` string, required: Creation timestamp
  - `completed_at` string, nullable: Completion timestamp (all jobs done)
  - `results` unknown[], nullable: Individual job results (when include_results=true)
    - unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/finedata/apis/finedata-api.md) · [All operations](https://skmtc.dev/finedata/apis/finedata-api/llms.txt) · [OpenAPI document](https://skmtc.dev/finedata/apis/finedata-api/revisions/d4321b98fd0e?raw)