Link a received invoice to a transaction by hand
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.
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.
apiKeyAuthorizationBearer <token>API key: gb_test_… or gb_live_…
id*stringIdempotency-Key?stringRecommended. 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.
length <= 255Getbeel-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.
uuidapplication/json- body
transaction_id*stringBank transaction of this reconciliation
^([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)$uuidinvoice_id*stringReceived invoice to link (GET /received-invoices)
1 <= length <= 100OK
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' \ -H 'Content-Type: application/json' \ -d '{ "transaction_id": "0fec1e58-b197-4052-99cf-2218496c5482", "invoice_id": "string"}'{ "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"}List the matches of a reconciliation GET
One row per transaction, newest transaction first: the invoice found (exact, fuzzy or manual) with its confidence, or unmatched.
Approve a match POST
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.