API reference · Financial
POST/api/v1/financial/reconciliation/run

Run financial reconciliation

Triggers FinancialService.runCreditReconciliation(). Optional client_id query narrows reconciliation target.

RBAC · financial

Query parameters

pagestringOptional
limitstringOptional
sortstringOptional
orderstringOptional
searchstringOptional
created_fromstringOptional
created_tostringOptional
updated_fromstringOptional
updated_tostringOptional
client_idstring <uuid>Optional
invoice_idstring <uuid>Optional
typestringOptional
statusstringOptional
amount_minstringOptional
amount_maxstringOptional
include_expiredstringOptional
expiring_soonstringOptional
has_remainingstringOptional
has_expirationstringOptional
date_fromstringOptional
date_tostringOptional
group_bystringOptional
include_projectionsstringOptional
as_of_datestringOptional

Response body

Success response 200 · schema FinancialInvoiceApiSuccess

dataanyOfRequired
anyOf (option 1)object
anyOf (option 2)array of object
itemsobject
metaobject

Response codes

200
Reconciliation run completed.
401
API key missing/invalid.
403
financial:update permission denied.
500
Unexpected reconciliation failure.