v1

latestOpenAPI 3.1.0AGPL-3.0-only2026-07-1773264353.7 KB

Invoices

List invoices

List invoices with optional filtering by customer, subscription, or status.

get/api/v1/invoices

Query parameters

customer_idstring

Filter by customer ID or alias

subscription_idstring MeteroidId

Example:sub_7n42DGM5Tflk9n8mt7Fhc7

statusesstring[]

order_bystring

Sort order. Format: column.direction. Allowed columns: invoice_number, customer_name, amount, invoice_date, status, payment_status. Direction: asc or desc. Default: invoice_date.desc.

pageinteger

Page number (0-indexed)

per_pageinteger

Number of items per page

Response

List of invoices

Example response

{
  "data": [
    {
      "currency": "EUR",
      "customer_details": {
        "billing_address": {
          "country": "US"
        },
        "id": "cus_7n42DGM5Tflk9n8mt7Fhc7"
      },
      "customer_id": "cus_7n42DGM5Tflk9n8mt7Fhc7",
      "id": "inv_7n42DGM5Tflk9n8mt7Fhc7",
      "subscription_id": "sub_7n42DGM5Tflk9n8mt7Fhc7",
      "transactions": [
        {
          "id": "pay_7n42DGM5Tflk9n8mt7Fhc7",
          "payment_method_id": "pm_7n42DGM5Tflk9n8mt7Fhc7"
        }
      ]
    }
  ]
}