API referenceInvoices
Payments recorded on an invoice, oldest first
GET
apiKeyheader
AuthorizationBearer <token>API key: gb_test_… or gb_live_…
id*stringGetbeel-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.
Format
uuidOK
application/json- response
object*stringdata*array<>has_more*booleannext_cursor*string|nullcurl -X GET 'https://www.getbeel.com/api/v1/invoices/string/payments'Example Response
{ "object": "list", "data": [ { "object": "invoice_payment", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "invoice_id": "string", "amount": "122.00", "date": "2026-10-29", "method": "bank_transfer", "source": "app", "note": "string", "created_at": "2019-08-24T14:15:22Z" } ], "has_more": true, "next_cursor": "string"}Invoice and reminder emails sent for an invoice GET
Previous Page
Record a payment (mark as paid) POST
Records a payment on an issued invoice (or proforma). Without amount it records everything still due (amount_due − amount_paid) and the invoice becomes paid (webhook invoice.paid); a smaller amount makes it partially_paid. amount_due is the total less the ritenuta d'acconto.