Convert bank statement PDFs into structured data. Upload a PDF, poll for completion, then export as JSON, CSV, XLSX, QBO, or Xero-compatible formats.
\nContact Support:
Name: Bankstatemently Support
Email: help@bankstatemently.com
Retrieve structured document data including accounts and transactions. Only available when document status is completed. Transactions are paginated. Rate limit: 60 requests per minute.
Set to true to include originalData (raw pre-normalization cell values) on each transaction. When enabled, max limit is reduced to 500.
Maximum number of transactions per page.
\n","type":"text/plain"},"key":"limit","value":"500"},{"description":{"content":"Number of transactions to skip for pagination.
\n","type":"text/plain"},"key":"offset","value":"0"}],"variable":[{"description":{"content":"The document UUID.
\n","type":"text/plain"},"type":"any","value":"893093cc-21d6-b881-ed5a-46dd9c3c4a65","key":"id"}]}},"response":[{"id":"b0d0a5b3-57f2-4f16-be01-afbcae1cd723","name":"Structured document data with accounts and transactions.","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: apikey","key":"X-API-Key","value":"Download the processed document in the specified format. The document must have status completed. Rate limit: 30 requests per minute.
The data flavor to export. original returns raw extracted data; enhanced (default) includes AI-enriched fields; normalized applies standardized formatting.
Date format string for Xero CSV exports (e.g., DD/MM/YYYY). Only applicable when format is xero.
The document UUID.
\n","type":"text/plain"},"type":"any","value":"893093cc-21d6-b881-ed5a-46dd9c3c4a65","key":"id"},{"description":{"content":"The export format.
\n","type":"text/plain"},"type":"any","value":"xlsx","key":"format"}]}},"response":[{"id":"75481b66-1cb8-4606-ac4b-c3fe9b2a84f9","name":"The exported file. Content-Type varies by format.","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: apikey","key":"X-API-Key","value":"Submit a password to unlock and process a password-protected PDF. The document must have status password_required. On success, the document transitions to processing status. Rate limit: 20 requests per minute.
The document UUID returned from the upload endpoint.
\n","type":"text/plain"},"type":"any","value":"893093cc-21d6-b881-ed5a-46dd9c3c4a65","key":"id"}]}},"response":[{"id":"9763b441-221d-4686-92bf-5b498a02b015","name":"Password accepted. Document is now processing.","originalRequest":{"method":"POST","header":[{"key":"Content-Type","value":"application/json"},{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: apikey","key":"X-API-Key","value":"Categorize a document's transactions using AI. Returns cached categories if already generated (no credit charge). Otherwise deducts 1 credit and runs LLM-based categorization. Rate limit: 20 requests per minute.
\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-API-Key"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"11c37c3c-db86-4fab-a0b4-b37cd2634064","id":"11c37c3c-db86-4fab-a0b4-b37cd2634064","name":"Bankstatemently API","type":"collection"}},"urlObject":{"path":["documents",":id","categorize"],"host":["https://api.bankstatemently.com/v1"],"query":[],"variable":[{"description":{"content":"Document UUID returned by the upload endpoint.
\n","type":"text/plain"},"type":"any","value":"0ea0bcc1-2dc2-b2cc-7c1d-2fb07f502914","key":"id"}]}},"response":[{"id":"ed376dc6-9359-4ec3-9522-744b37bac7e5","name":"Categories returned (cached or freshly generated).","originalRequest":{"method":"POST","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: apikey","key":"X-API-Key","value":"Poll the status of an uploaded document. When status is completed, the response includes statement metadata and export URLs. Rate limit: 120 requests per minute.
The document UUID returned from the upload endpoint.
\n","type":"text/plain"},"type":"any","value":"893093cc-21d6-b881-ed5a-46dd9c3c4a65","key":"id"}]}},"response":[{"id":"14b1e684-066d-44d6-8773-0dd33ef6bda7","name":"Document status and metadata.","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: apikey","key":"X-API-Key","value":"A unique key to ensure the request is processed at most once. Must be unique per request — use a UUID. Keys expire after 24 hours. If a duplicate key is detected, the original response is replayed with X-Idempotency-Replayed: true.
Original filename for the uploaded PDF. Used for display purposes only. Defaults to 'document.pdf' if not provided.
\n","key":"X-Filename","value":""},{"description":"Webhook URL for processing completion notifications. Overrides the default webhook URL configured on the API key.
\n","key":"X-Webhook-URL","value":""},{"description":"Decryption password for encrypted PDFs. When provided, the PDF is decrypted and processed in a single request — no need for the two-step unlock flow. The password is used in memory only and never stored or logged.
\n","key":"X-Password","value":""},{"key":"Content-Type","value":"application/pdf"},{"key":"Accept","value":"application/json"}],"body":{"mode":"raw","raw":"string"},"url":"https://api.bankstatemently.com/v1/documents","description":"Upload a PDF bank statement for conversion. The file is processed asynchronously. Poll the returned id via GET /v1/documents/{id} to check progress. Rate limit: 10 requests per minute.
Set to 'true' to reprocess a previously failed upload of the same file. Without this, re-uploading a failed file returns an already_processing error.
\n","type":"text/plain"},"key":"retry","value":"true"}],"variable":[]}},"response":[{"id":"18bb6e3a-5dfb-4c8f-905a-64639ba7a6e4","name":"Upload accepted. Processing has started, or the PDF requires a password.","originalRequest":{"method":"POST","header":[{"description":"A unique key to ensure the request is processed at most once. Must be unique per request — use a UUID. Keys expire after 24 hours. If a duplicate key is detected, the original response is replayed with `X-Idempotency-Replayed: true`.","key":"Idempotency-Key","value":"idk_abc123def456"},{"description":"Original filename for the uploaded PDF. Used for display purposes only. Defaults to 'document.pdf' if not provided.","key":"X-Filename","value":"statement-jan-2026.pdf"},{"description":"Webhook URL for processing completion notifications. Overrides the default webhook URL configured on the API key.","key":"X-Webhook-URL","value":"https://example.com/webhooks/bankstatemently"},{"description":"Decryption password for encrypted PDFs. When provided, the PDF is decrypted and processed in a single request — no need for the two-step unlock flow. The password is used in memory only and never stored or logged.","key":"X-Password","value":"string"},{"key":"Content-Type","value":"application/pdf"},{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: apikey","key":"X-API-Key","value":"Retrieve a paginated list of your uploaded documents, ordered by creation date descending. Rate limit: 120 requests per minute.
\n","auth":{"type":"apikey","apikey":{"basicConfig":[{"key":"key","value":"X-API-Key"},{"key":"value","value":""}]},"isInherited":true,"source":{"_postman_id":"11c37c3c-db86-4fab-a0b4-b37cd2634064","id":"11c37c3c-db86-4fab-a0b4-b37cd2634064","name":"Bankstatemently API","type":"collection"}},"urlObject":{"path":["documents"],"host":["https://api.bankstatemently.com/v1"],"query":[{"description":{"content":"Maximum number of documents to return.
\n","type":"text/plain"},"key":"limit","value":"20"},{"description":{"content":"Number of documents to skip for pagination.
\n","type":"text/plain"},"key":"offset","value":"0"},{"description":{"content":"Filter documents by processing status.
\n","type":"text/plain"},"key":"status","value":"password_required"}],"variable":[]}},"response":[{"id":"c115971d-8b03-4488-9704-4298c05c55ae","name":"Paginated list of documents.","originalRequest":{"method":"GET","header":[{"key":"Accept","value":"application/json"},{"description":"Added as a part of security scheme: apikey","key":"X-API-Key","value":"