DocsGuides

Going live

Check these before real traffic.

  1. Send an `Idempotency-Key` on every request, generated once per document and reused by every attempt. Without it, a timeout you retry is a second charge. See Idempotency and retries.
  2. Set a client timeout of at least 180 seconds. A long statement takes tens of seconds to parse, and a 30 second default turns a success into a retry.
  3. Filter on `account.type` before summing credits as income. See Amounts and directions.
  4. Branch on `verification.reconciled` and route anything false to a person. See Verification.
  5. Iterate `accounts` rather than reading accounts[0], and keep them separate. See Accounts and periods.
  6. Branch on `error.code`, not on the message or a substring of it.
  7. Keep four documents in flight or fewer, or handle 429 with a short backoff. See Limits.
  8. Store `doc.id` against whatever you parsed for. It is the handle for any support question later.

Volume#

Every organisation has a monthly document cap, which stops a runaway loop turning into an invoice. There is nothing to buy. Email [email protected] with your expected volume and we raise it before you hit it.

Support#

[email protected], with the documentId if there is one.

Something wrong or missing on this page? [email protected]