GetbeelDocs
Riferimento APIBank reconciliation

Run the AI matching of a statement again

For a statement in review, completed or failed: re-reads it and matches its transactions again (the previous transactions and matches are replaced), like Retry in the app. A new upload is reconciled automatically. 202; webhook reconciliation.completed when done. Refused (409) while a run is in progress or when an autofattura of the statement was sent to SDI. Live keys only (403 livemode_required with a test key): bank and connection data is real, there is no sandbox for it.

POST
/reconciliations

For a statement in review, completed or failed: re-reads it and matches its transactions again (the previous transactions and matches are replaced), like Retry in the app. A new upload is reconciled automatically. 202; webhook reconciliation.completed when done. Refused (409) while a run is in progress or when an autofattura of the statement was sent to SDI. Live keys only (403 livemode_required with a test key): bank and connection data is real, there is no sandbox for it.

Autorizzazione

apiKey
headerAuthorizationBearer <token>

API key: gb_test_… or gb_live_…

Idempotency-Key?string

Recommended. Retrying with the same key and body within 24 hours replays the first response (header Idempotent-Replayed: true) instead of acting twice. The same key with a different body returns 422 idempotency_key_reused.

Lengthlength <= 255
Getbeel-Company?string

Act on one of the account's client companies (its id from GET /companies) instead of the key's own account. 404 company_not_found when the key cannot act on it.

Formatuuid
application/json
  1. body
statement_id*string

Bank statement to reconcile again (status review, completed or failed)

Match^[A-Za-z0-9_-]+$
Length1 <= length <= 100

Corpo della risposta

OK

application/json
  1. response
object*string
id*string

Same id as the bank statement: one statement has one reconciliation

statement_id*string
status*string

The statement status: review means the AI matching finished and the matches can be reviewed

Value in"pending""processing""parsed""matching""review""completed""failed"
error_message*string|null
period_start*|null
period_end*|null
summary*
created_at*string
Match^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
Formatdate-time
processed_at*|null
Esempio di richiesta
curl -X POST 'https://www.getbeel.com/api/v1/reconciliations' \  -H 'Content-Type: application/json' \  -d '{  "statement_id": "string"}'
Esempio di risposta
{  "object": "reconciliation",  "id": "string",  "statement_id": "string",  "status": "pending",  "error_message": "string",  "period_start": "2026-10-29",  "period_end": "2026-10-29",  "summary": {    "transactions": -9007199254740991,    "to_confirm": -9007199254740991,    "reconciled": -9007199254740991,    "missing_invoice": -9007199254740991,    "no_invoice_needed": -9007199254740991,    "rejected": -9007199254740991  },  "created_at": "2019-08-24T14:15:22Z",  "processed_at": "2019-08-24T14:15:22Z"}