Name: PerfectParser
Availability: InStock

`GET /v1/extractions`

Retrieve a paginated list of all extraction jobs submitted in your workspace. You can filter results by parser or status.

Query Parameters

Parameter	Type	Required	Description
`parser_id`	`string`	❌	Filter results by a specific parser ID.
`status`	`string`	❌	Filter by status: `queued`, `pending`, `processing`, `completed`, `failed`, `partial`. Unknown values return `400`.
`since`	`string`	❌	ISO 8601 timestamp — return extractions updated after this time (useful for polling automation).
`limit`	`integer`	❌	Number of items to return. Default is `50`, max `100`.
`cursor`	`string`	❌	Pagination cursor from the previous page's response.

curl "https://api.perfectparser.com/v1/extractions?limit=10" \
  -H "X-API-Key: pp_live_your_secret_key"

Response 200 OK

{
  "extractions": [
    {
      "extraction_id": "ext_123",
      "parser_id": "prs_999",
      "parser_name": "Invoice Parser",
      "status": "completed",
      "file_count": 2,
      "page_count": 7,
      "credits_used": 7,
      "created_at": "2026-06-20T10:00:00.000Z",
      "updated_at": "2026-06-20T10:00:45.000Z",
      "completed_at": "2026-06-20T10:00:45.000Z",
      "document_summary": {
        "total": 2,
        "completed": 2,
        "failed": 0,
        "processing": 0
      }
    }
  ],
  "pagination": {
    "limit": 10,
    "has_next_page": false,
    "next_cursor": null
  }
}

Common Error Responses

HTTP Status	Error Code	Description
`401`	`UNAUTHORIZED`	Invalid or missing API key.

List Extractions

`GET /v1/extractions`

Common Error Responses

On this page