---
title: "Get bulk document extraction status"
method: POST
path: "/internal/api/document/bulk-status"
tags: ["DOCUMENT"]
---

# Get bulk document extraction status

`POST /internal/api/document/bulk-status`

## Request

- Base URL: `https://api.signalshq.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.signalshq.io/internal/api/document/bulk-status`
- Auth: OAuth 2
  - Password
  - Token URL: `/auth/login`

Returns the latest extraction status for multiple documents with pagination support. Useful for polling the status of multiple document extractions in a single request. Returns status information including current state, error messages, and timestamps. Documents not found in the extraction table will be listed in the 'not_found' array. Supports standard pagination parameters for consistent API structure.

## Query parameters

- `page` integer: Page number (1-based)
- `page_size` integer: Number of items per page (max 100)
- `sort_by` string, nullable: Field to sort by (created_at, status)
- `sort_order` 'asc' | 'desc': Sort order enumeration
- `search_query` string, nullable: Search term

## Request body

- BulkDocumentStatusRequest: Request schema for bulk document status polling
  - `client_id` string, uuid, required: Client ID for the documents
  - `document_ids` string[], required: List of document IDs to check status for

## Response `200`

Successful Response

- PaginatedBulkDocumentStatusResponse: Paginated response schema for bulk document status polling using standard pagination structure
  - `data` DocumentExtractionStatusItem[], required: List of document status data
    - `document_id` string, uuid, required: Document ID
    - `status` string, required: Current extraction status
    - `error_message` string, nullable: Error message if extraction failed
    - `last_updated` string, nullable: Last update timestamp
  - `meta` AppSchemasCommonPaginationPaginationMeta, required
    - `page` integer, required: Current page number
    - `page_size` integer, required: Number of items per page
    - `total_count` integer, required: Total number of items
    - `total_pages` integer, required: Total number of pages
    - `total` integer, required: Alias for total_count for backward compatibility
  - `not_found` string[], required: List of document IDs not found in extraction table

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/signalshq/apis/signals-api.md) - [All operations](https://skmtc.dev/signalshq/apis/signals-api/llms.txt) - [OpenAPI document](https://skmtc.dev/signalshq/apis/signals-api/revisions/2c22af3b5576?raw)