Documentation

Documents — parse (beta)

POST /v1/documents/parse — upload a PDF, scan or image and get cleanMarkdown back, transcribed by a routed vision model (defaultauto:vision — pin any vision-capable model with model). Built for the documents Indian enterprises actually hold: invoices, KYC, contracts, HR paperwork.

DPDP posture: processing is fully in-memory, zero-retention — document bytes and page images are never written to disk or logged; the response is the only output. Combine with data_policy: india_only and the parse never leaves India.

curl https://api.bharatrouter.com/v1/documents/parse \
  -H "Authorization: Bearer br-..." \
  -F [email protected]

JSON alternative: {"file": "<base64>", "model": "auto:vision", "pages": 10}. Response: {"object":"document.parse","pages":N,"markdown":"…","model":…,"provider":…}.

Field	What it does
`file`	multipart file field, or base64 string in JSON. PDF, PNG, JPG. Up to 32 MB.
`model`	Vision-capable catalog id or an `auto:*` preset. Default `auto:vision`.
`pages`	Cap pages parsed (server max 50 in beta).
`data_policy` / `provider` / `exclude`	Same routing controls as chat.

Metering: in the beta, each page is metered as a normal vision-model call (your BYOK key when routed there; platform routes at catalog rates). Roadmap: structured field extraction (schema-in → JSON-out, GST-invoice/KYC presets), opt-in Aadhaar/PAN redaction on output, and bulk parsing via /v1/batches.