# Docparser

Website: https://docparser.dev
Documentation: https://docparser.dev/docs
Base URL: https://app.docparser.dev/api/v1

Docparser turns supported business documents into structured JSON through an asynchronous API.

## Available endpoints

- POST /documents — submit a document job.
- GET /documents/:consumerRefId — retrieve the first organization-scoped job matching that consumer reference.

## Authentication

Send both headers on API requests:
- x-client-id
- x-client-secret

## Submission mode precedence

The request body selects exactly one mode in this order:
1. attachments[] selects email attachment mode.
2. documentUrls[] selects multi-image mode when attachments is not an array.
3. documentUrl selects single-document mode when neither array is present.

If both arrays are present, attachments wins. An empty winning array still selects that mode and then fails minimum-one-item validation.

## Selectable document types

- 0 — Invoice
- 1 — Purchase Order
- 2 — GRN
- 3 — Debit Note
- 4 — Credit Card Statement
- 5 — Credit Card Statement (multi-account)
- 9 — PO number only

## Job statuses

- initiated
- extracting
- classifying_email_content
- extracting_from_attachments
- processed
- error

## Webhooks

Supply a relative webhook path in webhookUrl. Docparser joins it to the API key's registered base URL and POSTs JSON.
A delivery makes up to three attempts: immediately, after 1 second, and after 3 seconds in total. Each attempt has a 15-second timeout; any 2xx response succeeds.
Webhook requests are not currently signed. Use HTTPS on the API key's registered base URL.

## Surface availability

- Portal: available
- API: available
- CLI: coming next
- MCP: coming next