Create reconciliation with upload

POST/api/v1/reconciliations/upload

Create a new bank reconciliation with direct file upload.

Supports PDF, CSV, and Excel bank statements. The file is uploaded to S3 and processed automatically.

The workflow will:

Upload file to S3
Parse the bank statement using AI (handles any format)
Fetch ledger transactions for the period
Run AI matching to suggest matches
Store results for review

Error 413: File too large (max 50 MB).

Operation ID: create_reconciliation_with_upload_api_v1_reconciliations_upload_post·View as markdown·OpenAPI slice

Authentication

Bearer token authentication. Pass your DayZero API token in the Authorization header and the target business UUID in x-business-id.

Parameters

Query

ledger_idstringrequired: ID of ledger to reconcile against
start_datestring · date-timerequired: Statement period start date
end_datestring · date-timerequired: Statement period end date
opening_balanceinteger: Opening balance in cents
closing_balanceinteger: Closing balance in cents
auto_startbooleandefault: True: Auto-start processing workflow

Responses

201Successful Response

Schema: SuccessEnvelope_CreateReconciliationWithUploadResponse_

successboolean
messagestring
codestring
dataCreateReconciliationWithUploadResponse

422Validation Error

Schema: HTTPValidationError

detailarray · ValidationErrorValidationError

5 fields

locarray · string | integerrequired
msgstringrequired
typestringrequired
inputobject
ctxobject

Code samples

POST/api/v1/reconciliations/upload

bash

curl -X POST 'https://api.ondayzero.com/api/v1/reconciliations/upload' \
  -H 'Authorization: Bearer dz_your_token' \
  -H 'x-business-id: YOUR_BUSINESS_ID' \
  -H 'Content-Type: application/json' \
  -d ''