List Parsers

Endpoint: GET /v1/parsers. Reference for retrieving a paginated list of your active parsers.

`GET /v1/parsers`

Returns a paginated list of your active parsers.

Query Parameters

Parameter	Type	Description
`limit`	`number`	Results per page (default: `20`, max: `100`).
`cursor`	`string`	Pagination cursor from a previous list response.

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

Response 200 OK

{
  "parsers": [
    {
      "parser_id": "prs_999",
      "name": "Invoice Parser",
      "description": "Extracts vendor and totals from invoices",
      "result_mode": "one_per_file",
      "document_type": "invoices",
      "schema": {},
      "fields": {},
      "has_sample_file": false,
      "created_at": "2026-06-20T10:00:00.000Z",
      "updated_at": "2026-06-20T10:00:00.000Z"
    }
  ],
  "pagination": {
    "limit": 20,
    "has_next_page": false,
    "next_cursor": null
  }
}

Each parser's result_mode is one_per_file (dashboard: One document per file) or one_per_page (dashboard: One document per page).

Common Error Responses

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

GET /v1/parsers

Common Error Responses

On this page

`GET /v1/parsers`