Moolre Documentation

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