Get all invoices for a subscription

curl --request GET \
  --url https://api.nomos.energy/subscriptions/{id}/invoices \
  --header 'Authorization: Bearer <token>'

{
  "object": "list",
  "items": [
    {
      "object": "invoice",
      "id": "inv_drjjua6ampd1op2fg98k89x8",
      "invoice_number": "H62SU12A-003",
      "month": 4,
      "year": 2025,
      "period_start": "2025-03-31T22:00:00Z",
      "period_end": "2025-04-30T22:00:00Z",
      "period_number": 3,
      "status": "open",
      "usage": 100,
      "total": 110.04,
      "issued_at": "2024-03-14T12:00:00Z",
      "paid_at": "2024-03-14T12:00:00Z"
    }
  ]
}

GET

subscriptions

{id}

invoices

Get all invoices for a subscription

curl --request GET \
  --url https://api.nomos.energy/subscriptions/{id}/invoices \
  --header 'Authorization: Bearer <token>'

{
  "object": "list",
  "items": [
    {
      "object": "invoice",
      "id": "inv_drjjua6ampd1op2fg98k89x8",
      "invoice_number": "H62SU12A-003",
      "month": 4,
      "year": 2025,
      "period_start": "2025-03-31T22:00:00Z",
      "period_end": "2025-04-30T22:00:00Z",
      "period_number": 3,
      "status": "open",
      "usage": 100,
      "total": 110.04,
      "issued_at": "2024-03-14T12:00:00Z",
      "paid_at": "2024-03-14T12:00:00Z"
    }
  ]
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

string

required

Example:

"sub_jd8mlscm062jb6ks50tck9gi"

Response

Invoices summarise the amounts owed/payed for their monthly electricity bill. They are generated once per month and cover all line items including cost for electricity, grid fees, taxes and other charges. The related PDFs are available via the /invoices/{id}/file endpoint.

object

enum<string>

required

Available options:

list

items

object[]

required

Show child attributes

items.object

enum<string>

required

Available options:

invoice

items.id

string

required

Unique identifier of the invoice.

Example:

"inv_drjjua6ampd1op2fg98k89x8"

items.invoice_number

string

required

Human-readable invoice number displayed on the invoice document

Example:

"H62SU12A-003"

items.month

number

required

Numeric month (1-12) for which the invoice is issued

Example:

4

items.year

number

required

Four-digit year for which the invoice is issued

Example:

2025

items.period_start

string | null

required

Timestamp marking the beginning of the billing period (inclusive)

Example:

"2025-03-31T22:00:00Z"

items.period_end

string | null

required

Timestamp marking the end of the billing period (exclusive)

Example:

"2025-04-30T22:00:00Z"

items.period_number

number

required

Sequential number of the billing period within the subscription (1-based)

Example:

3

items.status

enum<string>

required

Current status of the invoice:

Available options:

open,

paid,

voided

Example:

"open"

items.usage

number

required

Total energy consumption in kilowatt-hours (kWh) during the billing period

Example:

100

items.total

number

required

Total amount due in euros (EUR) including all fees, taxes, and energy costs

Example:

110.04

items.issued_at

Timestamp when the invoice was issued

Example:

"2024-03-14T12:00:00Z"

items.paid_at

Timestamp when the invoice is due

Example:

"2024-03-14T12:00:00Z"

Get an invoice PDF file Get a lead

⌘I

API Reference (2025-12-01.chucky)

Authorizations

Path Parameters

Response