Developers

ParseMind API

HTTP/JSON document extraction with real OCR upstream and transparency headers on every response. Public docs — authenticate with API keys for extraction endpoints.

Get API access Check upstream Postman collection Platform status

Base URL

https://parsemind.net/api/v1

Authentication

Authorization: Bearer pm_live_xxxxxxxx
X-API-Key: pm_live_xxxxxxxx

Create keys after sign in.

Rate limits

60 requests per minute per API key (per user account). Exceeding the limit returns 429 with rate_limit_exceeded. 

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 42
Retry-After: 12   # only on 429

Transparency headers

X-ParseMind-Upstream-OCR: https://billsense.net/ocr
X-ParseMind-Upstream-PDF: https://billsense.net/pdf
X-ParseMind-Real-Calls: yes

Reference

Endpoints

GET /api/v1/ping

Health check (API key required).

GET /api/v1/industries

List enabled industries.

GET /api/v1/industries/{slug}/templates

Template schemas per industry.

POST /api/v1/extract

Sync upload + extract + structured JSON.

POST /api/v1/documents

Async queue (202) — poll by UUID.

GET /api/v1/documents/{uuid}

Status and extracted data.

GET /api/v1/documents/{uuid}/export.csv

Download transactions as CSV.

GET /api/v1/documents/{uuid}/filing-formats

List tax filing export formats for document.

GET /api/v1/documents/{uuid}/export/filing?format=…

Tax filing prep export (ClearTax, GSTR-1 JSON, Tally, Zoho, TDS, ITR).

POST /api/v1/documents/{uuid}/reanalyze

Re-run LLM normalization.

GET /api/v1/usage

Quota usage for current month.

GET /api/v1/_debug/upstream

Public — upstream service URLs.

Example: sync extract

curl -X POST https://parsemind.net/api/v1/extract \
  -H "Authorization: Bearer pm_live_xxx" \
  -F "industry=finance" \
  -F "template=bank_statement" \
  -F "file=@statement.pdf"

Tax & compliance (GST invoice):

curl -X POST https://parsemind.net/api/v1/extract \
  -H "Authorization: Bearer pm_live_xxx" \
  -F "industry=tax" \
  -F "template=gst_invoice" \
  -F "file=@gst-invoice.pdf"

Filing prep export (after extract):

curl -o gstr1.json -H "Authorization: Bearer pm_live_xxx" \
  "https://parsemind.net/api/v1/documents/{uuid}/export/filing?format=gstr1_b2b_json"

Formats: cleartax_sales_simple, gstr1_b2b_json, tally_sales_voucher, zoho_books_bill, tds_reconciliation_csv, itr_prep_json

Bulk export + ClearTax API:

curl -X POST https://parsemind.net/api/v1/tax/exports \
  -H "Authorization: Bearer pm_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{"from":"2025-04-01","to":"2025-04-30","direction":"purchase","push_to_cleartax":true}'

Outbound webhooks (teams)

Configure at Integrations → Webhooks (team admins). Events: document.completed, document.failed. HMAC header X-ParseMind-Signature.