List invoices | Mitu API Documentation

{
  "message": "Invoices retrieved successfully",
  "data": [
    {
      "id": "inv_4k2m9x7ptw3c",
      "invoice_number": "INV-2026-0041",
      "status": "draft",
      "recipient": {
        "id": "rcp_ds9hazr8jd3l",
        "name": "Ada Lovelace",
        "email": "ada@example.com",
        "phone": "+2348012345678",
        "reference": "user_42",
        "created_at": "2026-09-11T15:00:34.915Z"
      },
      "description": "September retainer",
      "line_items": [
        {
          "name": "Large pizza",
          "quantity": 2,
          "amount": 12.5,
          "description": "Pepperoni, thin crust"
        }
      ],
      "subtotal": "1500.00",
      "tax_amount": "0.00",
      "discount_amount": "0.00",
      "amount": "1500.00",
      "currency": "USD",
      "url": {
        "checkout": "https://mitu.ai/pay/pay_n8d7piu1yc6h",
        "agent": "https://api.mitu.ai/pay/pay_n8d7piu1yc6h"
      },
      "due_at": "2026-09-30T23:59:59.000Z",
      "sent_at": "2026-09-11T15:00:34.915Z",
      "viewed_at": "2026-09-11T15:00:34.915Z",
      "paid_at": "2026-09-11T15:00:34.915Z",
      "created_at": "2026-09-11T15:00:34.915Z"
    }
  ],
  "meta": {
    "total": 84,
    "limit": 20,
    "has_more": true,
    "next_cursor": "cur_01HXYZ9999XXXXXX"
  }
}

List your invoices.

Authentication

x-api-keystring

Account API key used to authenticate server-side requests. Use the credentials issued for the same environment as the API base URL.

Query parameters

statusenumOptional

Filter by invoice status.

recipientIdstringOptional

Return invoices addressed to a specific recipient.

recipientReferencestringOptional

Return only invoices whose recipient has this reference.

limitintegerOptional1-100Defaults to 20

Maximum number of records to return.

cursorstringOptional

Cursor returned as next_cursor from the previous response. Omit for the first request.

Response

Invoices retrieved successfully.

messagestring

datalist of objects

metaobject

Errors

401

Unauthorized Error

403

Forbidden Error

422

Unprocessable Entity Error

429

Too Many Requests Error

500

Internal Server Error