API Reference · Invoices

List invoices

Returns a cursor-paginated list of invoices.

GET/v1/invoices

Filter by status or customer. Sorted by `created` descending.

Returnslist of invoice objects

Query parameters

limitintegerdefault: 10

Max results.

Constraints: 1 <= limit <= 100

starting_afterstring

Cursor for the next page.

ending_beforestring

Cursor for the previous page.

customerstring

Filter to invoices for a single customer id.

statusstring

Filter by status.

Allowed values: DRAFT OPEN PAID VOID UNCOLLECTIBLE

Request

curl https://lunipay.io/api/v1/invoices?status=OPEN&limit=10 \
  -H "Authorization: Bearer sk_test_YOUR_KEY"

Response

{
  "object": "list",
  "data": [
    {
      "id": "inv_01JRZK7T9A3BXCZV2QKH5E8RMP",
      "object": "invoice",
      "livemode": false,
      "customer_id": "cus_01JRZK2Q4T9ZS0VCNA3HX7W9EY",
      "invoice_number": "INV-0042",
      "status": "OPEN",
      "currency": "usd",
      "subtotal_cents": 10000,
      "tax_rate_bps": 1500,
      "tax_amount_cents": 1500,
      "total_cents": 11500,
      "amount_paid_cents": 0,
      "amount_due_cents": 11500,
      "payment_terms": "net_30",
      "due_date": "2026-05-14",
      "notes": "Thanks for your business.",
      "line_items": [
        {
          "description": "Consulting — April 2026",
          "quantity": 10,
          "unit_price_cents": 1000,
          "total_cents": 10000
        }
      ],
      "installment_enabled": false,
      "installment_count": null,
      "hosted_invoice_url": "https://lunipay.io/pay/inv_01JRZK7T9A3BXCZV2QKH5E8RMP",
      "metadata": null,
      "sent_at": null,
      "paid_at": null,
      "created": 1713100800,
      "updated": 1713100800
    }
  ],
  "has_more": false
}