Invoice OCR API docs

Authentication

API key (header: X-API-Key)

Send your key on every request. Do not put keys in client-side code or public repos. Rotate keys from the dashboard if a secret is exposed.

X-API-Key: YOUR_API_KEY

Rate limits

Default catalog limit: From 5 req/min. Plan-specific limits apply after you subscribe. When throttled, expect 429 with a retryable response — back off and retry with jitter.

• Extract invoice: Plan-based
• Extraction job status: Plan-based

Errors

Errors return JSON with a machine-readable code and message. Common platform codes:

• 401 — missing or invalid API key
• 403 — key valid but not entitled for this API or plan
• 404 — resource or path not found
• 429 — rate limit exceeded; retry later
• 5xx — upstream or platform failure; retry with backoff

Endpoint-specific errors are listed under each endpoint below.

Versioning

Current documented version: v1. Prefer pinning the version path shown in examples. Breaking changes ship under a new version; check the changelog for platform updates.

Extract invoice

Upload or reference an invoice and receive structured fields.

Parameters

Example code

curl -s -X POST "https://invocr.apiseeker.com/v1/invoice" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "documentUrl": "https://example.com/sample-invoice.pdf"
}'

Response example

{
  "vendor": "Example Supplies",
  "invoiceNumber": "INV-1001",
  "currency": "INR",
  "total": 11800,
  "tax": 1800,
  "lineItems": [
    {
      "description": "Service",
      "amount": 10000
    }
  ]
}

Errors

• 400 — Unsupported file type
• 401 — Missing or invalid API key
• 413 — File too large
• 429 — Rate limit exceeded

Extraction job status

Poll async OCR job status by id.

Parameters

Example code

curl -s "https://invocr.apiseeker.com/v1/invoice/jobs/{jobId}" \
  -H "X-API-Key: YOUR_API_KEY"

Response example

{
  "jobId": "job_01",
  "status": "completed",
  "result": {
    "vendor": "Example Supplies",
    "total": 11800
  }
}

Errors

• 401 — Missing or invalid API key
• 404 — Job not found