Invoices
List your Keepable invoices for the last 12 months and download any of them as a PDF, straight from the API.
Keepable bills each sending organisation per billing period. The Sender API lets you pull your invoice history and download any invoice as a PDF, so you can reconcile against your own ledger without logging into the portal.
Reading invoices needs the invoices.read scope.
List invoices
Returns your invoices for the trailing 12 months, newest period first.
curl https://api.keepable.co/sender/invoices \
-H "Authorization: Bearer $KEEPABLE_TOKEN" \
-H "Keepable-Version: 2026-05-24"{
"invoices": [
{
"id": "inv_01HXP",
"period_start": "2026-04-01",
"period_end": "2026-04-30",
"currency": "NGN",
"subtotal_kobo": 4500000,
"tax_kobo": 337500,
"total_kobo": 4837500,
"status": "issued",
"issued_at": "2026-05-01T00:00:00Z"
}
]
}Amounts are in kobo, the minor unit of the invoice currency (100 kobo =
₦1). total_kobo of 4837500 is ₦48,375.00. Divide by 100 to display; never
round in the wrong direction.
| Field | Notes |
|---|---|
period_start / period_end | The billing period covered, date-precision and inclusive. |
subtotal_kobo | Sum of line items, in kobo. |
tax_kobo | Tax (e.g. VAT), in kobo. |
total_kobo | Payable total (subtotal + tax), in kobo. |
status | draft, issued, paid, or void. |
issued_at | When the invoice was issued. |
Download the PDF
Fetch any invoice as a formatted PDF by id:
curl https://api.keepable.co/sender/invoices/inv_01HXP/pdf \
-H "Authorization: Bearer $KEEPABLE_TOKEN" \
-H "Keepable-Version: 2026-05-24" \
-o invoice-2026-04.pdfThe PDF is the same document your finance team sees in the portal, suitable for filing and reconciliation.
Access delegation
Let one tenant act on behalf of another. Request access to a tenant, and accept or reject requests targeting yours.
Webhooks
React to events as they happen instead of polling. Register an endpoint, subscribe to event types, and receive signed CloudEvents when content arrives, agreements progress, or consent is decided.