Approve a match
Confirms the invoice found; for an unmatched payment, confirms that no invoice is needed. Live keys only (403 livemode_required with a test key): bank and connection data is real, there is no sandbox for it.
Confirms the invoice found; for an unmatched payment, confirms that no invoice is needed. Live keys only (403 livemode_required with a test key): bank and connection data is real, there is no sandbox for it.
apiKeyAuthorizationBearer <token>API key: gb_test_… or gb_live_…
id*stringmatchId*stringuuidGetbeel-Company?stringAct 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.
uuidOK
application/json- response
object*stringid*string^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$uuidreconciliation_id*stringmatch_type*stringexact and fuzzy: found by the AI (fuzzy needs a closer look); manual: linked by a person; unmatched: no invoice found
"exact""fuzzy""manual""unmatched"state*stringto_confirm: an invoice was found, waiting for approval; reconciled: invoice confirmed; missing_invoice: no invoice found for the payment; no_invoice_needed: marked as not needing one; rejected: the suggested match was rejected
"to_confirm""reconciled""missing_invoice""no_invoice_needed""rejected"review_status*string"pending""approved""rejected""modified"confidence*stringAI confidence from 0.00 to 1.00
reasons*array<string>amount_difference*|nulltransaction*invoice*|The received (supplier) invoice matched
reviewed_at*|nullcurl -X POST 'https://www.getbeel.com/api/v1/reconciliations/string/matches/497f6eca-6276-4993-bfeb-53cbbbba6f08/approve'{ "object": "reconciliation_match", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "reconciliation_id": "string", "match_type": "exact", "state": "to_confirm", "review_status": "pending", "confidence": "0.95", "reasons": [ "string" ], "amount_difference": "122.00", "transaction": { "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "date": "2026-10-29", "description": "string", "counterparty_name": "string", "amount": "122.00", "currency": "string" }, "invoice": { "id": "string", "vendor_name": "string", "invoice_number": "string", "invoice_date": "2026-10-29", "amount_total": "122.00", "currency": "string" }, "reviewed_at": "2019-08-24T14:15:22Z"}Link a received invoice to a transaction by hand POST
Replaces the transaction's match with the given received invoice (match_type manual, review_status modified). Live keys only (403 livemode_required with a test key): bank and connection data is real, there is no sandbox for it.
Reject a match POST
The suggested invoice is wrong. Live keys only (403 livemode_required with a test key): bank and connection data is real, there is no sandbox for it.