Beta

List invoices

​

Returns a paginated list of invoices for your account. Invoices are created by billing flows such as subscription creation, subscription renewal, and dunning retries.

Related guides: Invoices, Subscriptions, and Webhooks

Query Parameters
  • limit
    Type: integer
    min:  
    1
    max:  
    100

    Maximum number of invoices to return.

  • last_key
    Type: string

    Opaque cursor for pagination. Use the last_key value from the previous response to retrieve the next page.

  • expand
    Type: array string[]enum
    const:  
    customer

    Pass customer to return the full Customer object in the customer field instead of only the customer ID.

    values
    • customer
Responses
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for get/v1/invoices
curl 'https://api.paypercut.io/v1/invoices?limit=1&last_key=eyJsYXN0SWQiOiIyMTIxMDAyMWMyODU1MDA3ZWZhMmQ2NTcwMTgiLCJsYXN0Q3JlYXRlZEF0IjoiMjAyNC0wMS0xNVQxMDozMDowMFoifQ%3D%3D&expand=customer' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "items": [
    {
      "id": "01KA9TBINVOICE123456789",
      "object": "invoice",
      "customer": "01KA9SXYZ123456789ABCDEFGH",
      "status": "paid",
      "created": "2026-03-01T00:00:00Z",
      "updated": "2026-03-01T00:00:12Z",
      "livemode": true,
      "billing_reason": "subscription_cycle",
      "collection_method": "charge_automatically",
      "currency": "USD",
      "amount_due": 2000,
      "amount_paid": 2000,
      "amount_remaining": 0,
      "period": {
        "start": "2026-03-01T00:00:00Z",
        "end": "2026-04-01T00:00:00Z"
      },
      "parent": {
        "type": "subscription_details",
        "subscription_details": {
          "subscription": "01KA9TSUBSCRIPTION123",
          "metadata": {
            "plan": "pro"
          }
        }
      },
      "lines": {
        "object": "list",
        "data": [],
        "has_more": false,
        "url": "/v1/invoice_lines?invoice=01KA9TBINVOICE123456789"
      },
      "payments": {
        "object": "list",
        "data": [],
        "has_more": false,
        "url": "/v1/invoice_payments?invoice=01KA9TBINVOICE123456789"
      },
      "status_transitions": {
        "finalized_at": "2026-03-01T00:00:03Z",
        "marked_uncollectible_at": null,
        "paid_at": "2026-03-01T00:00:12Z",
        "voided_at": null
      },
      "last_finalization_error": null,
      "metadata": {
        "order_id": "sub-renewal-1042"
      }
    }
  ],
  "last_key": null
}

List of invoices.