Invoices

Get Invoice

Get a single invoice by ID with related customer, subscription, payment, and any adjustment invoices. Includes whether a PDF is available without exposing the direct URL.

GET
/invoices/{id}

Authorization

bearerAuth
AuthorizationBearer <token>

Use your secret API key as the bearer token

In: header

Path Parameters

id*string

Invoice ID

Match^inv_[A-Za-z0-9]{22}$

Response Body

application/json

application/json

application/json

curl -X GET "https://api.getlumen.dev/v1/invoices/string"
{
  "invoice": {
    "id": "inv_c9MBd7QfJH5s2r4aLvXK",
    "customerInvoiceNumber": "LO4XGG-001",
    "customerId": "cus_Lo4xGg1Yk9pB2eWv3sNt",
    "subscriptionId": "sub_int_mXa8QbHnC1sRf7L2gE",
    "status": "issued",
    "totalAmountCents": 12900,
    "currency": "USD",
    "hasPdf": true,
    "adjustmentInvoices": [
      {
        "id": "inv_adj_9A6f",
        "customerInvoiceNumber": "LO4XGG-CN-001",
        "documentType": "credit_note",
        "totalAmountCents": -12900,
        "currency": "USD",
        "issueDate": "2025-02-21T00:00:00.000Z",
        "hasPdf": true
      }
    ]
  }
}
{
  "error": "Invoice not found"
}
{
  "error": "Failed to fetch invoice"
}