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_id string required: ID of ledger to reconcile against
start_date string · date-time required: Statement period start date
end_date string · date-time required: Statement period end date
opening_balance integer: Opening balance in cents
closing_balance integer: Closing balance in cents
auto_start boolean default: True: Auto-start processing workflow

Responses

201 Successful Response

422 Validation Error

Schema: HTTPValidationError

detail array · ValidationError ValidationError

5 fields

loc array · string | integer required
msg string required
type string required
input object
ctx object

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 ''

javascript

const response = await fetch('https://api.ondayzero.com/api/v1/reconciliations/upload', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer dz_your_token',
    'x-business-id': 'YOUR_BUSINESS_ID',
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({}),
});
const data = await response.json();

python

import httpx

headers = {
    "Authorization": "Bearer dz_your_token",
    "x-business-id": "YOUR_BUSINESS_ID",
}

payload = {}

response = httpx.post("https://api.ondayzero.com/api/v1/reconciliations/upload", headers=headers, json=payload)
data = response.json()