One API, the same as the app
The portal's own screens use the public API. Upload a file, get the fields, the verdict and the reasons back as JSON.
How-to videos
- Bulk files through the API · A PDF of many invoices, or a ZIP of files, in one call to /v1/uploads.
- Correct, approve and export · Fix an invoice, approve the batch, and get Excel and TallyPrime files, all through the API.
- The API from Python · A short script: send each invoice, wait for the answer, print what needs a person.
- Errors and safe retries · One error shape, retries that never charge twice, an Idempotency-Key, and what to do on 429.
- Webhooks, end to end · Be told the moment each invoice is read, signed so you know it came from us.
Three calls
1. Upload
curl -X POST "https://saffronscroll.com/v1/documents?wait=true" \
-H "Authorization: Bearer ocr_YOUR_KEY" \
-H "Idempotency-Key: purchase-2041" \
-F "[email protected]"2. Fetch the result
curl "https://saffronscroll.com/v1/documents/DOCUMENT_ID" \
-H "Authorization: Bearer ocr_YOUR_KEY"3. Webhook
POST https://your-server.example/hooks/invoices
X-Ocr-Signature: sha256=<HMAC-SHA256 of the body, with your secret>
{"event": "document.completed", "document": { ...same as the fetch above... }}- Make API keys in the app, once your email address is confirmed. A key is shown in full only once.
- Send an
Idempotency-Keyheader to make a retry safe. The same file sent again by the same account returns the earlier document and is not charged. - Pages are charged per page read. A failed read is not charged.
- The price is the same as in the app.
New accounts get 10 pages free, valid for 30 days.
Pages from ₹0.46 each, GST extra (18%).
Unused pages expire after the validity shown. No subscription, nothing renews by itself. A failed read and a file you send twice are not charged.