API Reference / Invoices
Invoice status
POSThttps://api.moolre.com/open/invoice/status
Read one invoice by its invoiceid or your reference.
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.
- invoiceid string optional
The invoiceid returned by Create invoice, for example 5-1. Send invoiceid or reference.
- reference string optional
Your invoice reference. Send invoiceid or reference.
Responses
200 Success
The invoice object.
{ "status": 1, "code": "INV15", "message": "Invoice found.", "data": { "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" }, "go": null, "meta": { "requestid": "req_c68f4c66115c26725c796242", "notices": [] }}200 (HTTP 404 in strict mode) Invoice not found
No invoice matches on this wallet.
{ "status": 0, "code": "INV12", "message": "Invoice not found.", "data": "invoiceid", "go": null, "meta": { "requestid": "req_c68f4c66115c26725c796242", "notices": [] }}