Create reconciliation

POST /api/v1/reconciliations

Create a new bank reconciliation (with S3 key).

Use this endpoint if you've already uploaded the statement to S3. For direct file upload, use POST /reconciliations/upload instead.

Request Body:

  • ledger_id: UUID of ledger to reconcile against (required)
  • statement_s3_key: S3 key of uploaded bank statement (required)
  • start_date: Statement period start date in ISO 8601 format (required)
  • end_date: Statement period end date in ISO 8601 format (required)
  • statement_filename: Original filename (optional)
  • opening_balance: Opening balance in cents (optional)
  • closing_balance: Closing balance in cents (optional)
  • auto_start: Auto-start processing workflow (optional, defaults to true)
Operation ID: create_reconciliation_api_v1_reconciliations_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.

Request body

Schema: ReconciliationCreateRequest

ledger_id string required

ID of ledger to reconcile against

statement_s3_key string required

S3 key of uploaded bank statement

start_date string · date-time required

Statement period start date

end_date string · date-time required

Statement period end date

statement_filename string

Original filename

opening_balance integer

Opening balance in cents

closing_balance integer

Closing balance in cents

auto_start boolean

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