DocsGuides

Verification

Every response carries a check of the extraction against the document it came from. Read it before you use the figures.

What is checked#

  • Every amount appears in the document. An amount printed nowhere in the PDF is an error, and it is caught before the document is returned.
  • Balances close. Where the statement prints an opening and a closing balance, the transactions must account for the movement between them exactly.
  • Printed totals are compared against our own sum.
  • Missing sections are reported, so a statement missing part of itself does not come back looking complete.

The field#

json
"verification": {
  "reconciled": false,
  "issues": [
    "Closing balance 1602.56 does not follow from opening balance 1204.11 and the rows returned (difference 42.10)."
  ]
}
reconciledissuesMeaning
trueemptyChecked, nothing wrong. Use the figures.
falsenon-emptySomething is wrong. Treat the figures as unverified and put the document in front of a person.
falseemptyThe document could not be checked, usually because the issuer printed no balances and no totals.

Printed totals#

Issuers disagree about what their own totals mean. Amex's total new spend is net of refunds; most banks' equivalent is not. A gap between totals and statedTotals does not on its own make a document unreconciled.

When reconciled is false#

  1. Keep the document. The rows are still there and are usually right.
  2. Do not present the totals as verified.
  3. Send it to manual review with doc.id and verification.issues attached.
  4. If you think a document should have passed, email us the doc.id. We keep no transactions, so that is what we need to look into it.

A document that fails the check is still billable. It returned 200 and the rows were extracted.

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