Moolre Documentation

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": []  }}