Security and data retention
A file you send directly is read and discarded. The result is kept for the retention period you choose, so you can fetch it again, and deleted when it ends or when you delete it.
What happens to a file you send#
| Sent | The file |
|---|---|
| Synchronously | Read in memory and dropped when the response is written. Never stored. |
With async=true | Held until the read finishes, then deleted. |
| Through a collection | Kept with its document, so you can download it, and deleted with it. |
A PDF's password opens that one file. With async=true it is held, encrypted, until the read finishes, and then deleted.
What we keep#
| Kept | Why | For how long |
|---|---|---|
| The document: the read result, in any state. | So you can fetch it, list it and receive it by webhook. | Your retention period: 30 days by default, 1 to 90. |
| A collection upload's original file. | You never had a copy. | As long as its document. |
Each Idempotency-Key, with the id of the document it produced. | So a retry returns that document instead of reading the file again and charging twice. | 24 hours. |
| A usage entry per request: time, status, error code, size, pages, duration, filename, issuer name, account and row counts, and a fingerprint of the file. | Invoices are settled from it, and the fingerprint flags a file sent twice. | The life of the account. |
| API keys, in a form that cannot be read back. Test keys in full. | To authenticate you. | Until the key is revoked. |
| Webhook deliveries. | So you can see what was sent and whether it arrived. | 30 days. |
Retention#
- An admin sets the retention period in the console's Settings, from 1 to 90 days. It applies to documents read after the change.
- Documents past their period are deleted within a day, with any stored file. They then return
404 document_not_found. - Test documents are kept for the same period.
- Closing a collection does not delete its documents.
Deleting#
DELETE /api/v1/documents/{id}deletes a document and any stored file at once. See Documents.- Delete from the console's Documents page.
- Usage entries can be removed on request, though they are what an invoice is explained from. Email [email protected].
Transport and access#
- TLS on every request. The API is not reachable over plain HTTP.
- Keys are long random strings, revocable by you at any time. See Authentication.
- Webhooks go only to
httpsendpoints and are signed with a secret per endpoint. See Webhooks. - Console access is per person, by role. See Console and teams.
- The person whose statement it is has no account here and is never contacted by us.
AI processing#
Reading a statement uses an AI model, and the statement's text, or for a scan or photo its page images, is processed by our model provider to do it. We train nothing on your documents. Email [email protected] if your compliance review needs the provider named and its data processing terms.
Something wrong or missing on this page? [email protected]