---
title: "Get batch job summary with query filters"
method: POST
path: "/api/v1/batches/summary/"
tags: ["openAiBatch"]
---

# Get batch job summary with query filters

`POST /api/v1/batches/summary/`

Dashboard-authenticated extension for aggregated batch job statistics. The backend delegates POST to GET, so filters are query parameters (`status`, `provider_id`) and request bodies are ignored.

## Query parameters

- `status` string
- `provider_id` string

## Headers

- `Authorization` string, required

## Response `200`

Batch job summary.

- OpenAIBatchFilterBatchJobsSummaryResponse200
  - `total_batches` integer, required
  - `active_batches` integer, required
  - `completed_batches` integer, required
  - `failed_batches` integer, required
  - `total_cost` number, double
  - `total_requests` integer
  - `total_completed_requests` integer
  - `total_failed_requests` integer
  - `by_status` object
  - `by_provider` object

## 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)