API Reference / Invoices
List invoices
POSThttps://api.moolre.com/open/invoice/list
List invoices for a wallet, newest first, with cursor pagination.
Headers
- X-API-USER string required
Your Moolre username.
- X-API-KEY string required
Your wallet private API key. A public key is refused.
Body parameters
- accountnumber string required
Your Moolre wallet account number.
- limit integer optional
Invoices per page, 1 to 100. Default 25.
- starting_after string optional
An invoiceid: send next_cursor from the previous page.
- status string optional
Filter by status.
- reference string optional
Filter by your reference.
- service_id string optional
Filter by collection service.
Responses
200 Success
A page of invoices with cursor fields.
{ "status": 1, "code": "INV14", "message": "Invoices found.", "data": { "invoices": [ { "invoiceid": "5-1", "status": "pending", "reference": "INV-1001", "invoice_name": "Term 1 fees", "currency": "GHS", "total": "100.00", "amount_paid": "0.00", "tax": "0", "items": [ { "amount": "50.00", "quantity": "2", "description": "Tuition" } ], "customer": { "name": "Ama Mensah", "phone": "0240000001", "email": "" }, "narration": "Term 1 fees", "due_date": "2026-12-31T23:59:59Z", "payment_link": "https://invoice.moolre.com/5-1", "payment_code": "*203*0621#", "metadata": null, "created": "2026-11-15T09:00:00Z" } ], "has_more": false, "next_cursor": null }, "go": null, "meta": { "requestid": "req_c68f4c66115c26725c796242", "notices": [] }}