---
title: "List batch jobs with query filters"
method: POST
path: "/api/v1/batches/list/"
tags: ["openAiBatch"]
---

# List batch jobs with query filters

`POST /api/v1/batches/list/`

Dashboard-authenticated POST-for-filtering route for batch jobs. The backend delegates POST to GET, so filters are query parameters (`status`, `provider_id`) and request bodies are ignored.

## Query parameters

- `page` integer
- `page_size` integer
- `status` string
- `provider_id` string

## Headers

- `Authorization` string, required

## Response `200`

Paginated filtered list of batch jobs.

- OpenAIBatchFilterBatchJobsResponse200
  - `count` integer, required — Total number of matching batch jobs.
  - `next` string, nullable — URL for the next page, if any.
  - `previous` string, nullable — URL for the previous page, if any.
  - `results` ApiV1BatchesListPostResponsesContentApplicationJsonSchemaResultsItems[], required
    - `id` string, required — Provider batch ID.
    - `provider_id` string, required — Provider ID.
    - `status` 'validating' | 'pending' | 'in_progress' | 'finalizing' | 'completed' | 'failed' | 'expired' | 'cancelling' | 'cancelled', required
    - `request_count` integer
    - `completed_count` integer
    - `failed_count` integer
    - `total_cost` number, double
    - `is_usage_tracked` boolean — Whether usage for this batch has been reconciled.
    - `is_active` boolean — Whether the batch is still active.
    - `is_terminal` boolean — Whether the batch has reached a terminal status.
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `completed_at` string, date-time, nullable
    - `last_polled_at` string, date-time, nullable
    - `start_log_unique_id` string, nullable — Log ID for the batch creation event.
    - `completion_log_unique_id` string, nullable — Log ID for the completion event, when available.
    - `provider_data` object — Provider metadata such as input file and endpoint.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized - Missing or invalid authentication

---

[API](https://skmtc.dev/keywordsai/apis/api-reference.md) · [All operations](https://skmtc.dev/keywordsai/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/keywordsai/api-reference/revisions/58a2eabdccf3/schema)