Skip to main content
GET
/
subscriptions
/
{id}
/
invoices
List invoices
curl --request GET \
  --url https://api.nomos.energy/subscriptions/{id}/invoices \
  --header 'Authorization: Bearer <token>'
{
  "items": [
    {
      "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",
      "type": "usage",
      "usage": 100,
      "total": 110.04,
      "issued_at": "2024-03-14T12:00:00Z",
      "paid_at": "2024-03-14T12:00:00Z"
    }
  ],
  "next_page": "<string>",
  "has_more": false
}

Documentation Index

Fetch the complete documentation index at: https://docs.nomos.energy/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

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

Path Parameters

​
id
string
required
Example:

"sub_jd8mlscm062jb6ks50tck9gi"

Query Parameters

​
cursor
string | null
​
limit
number
default:10
Required range: 1 <= x <= 100
​
filter[field][operator]
any | null

Filterable fields:

  • status (enum): open, paid
  • period_start (date)
  • period_end (date)
  • type (enum): usage, prepayment

See Filtering Documentation for supported operators and syntax.

Example:

"value"

Response

Invoices summarise the amounts owed/payed for a subscription. Usage invoices (type: "usage") bill the metered electricity consumption of a billing period and include all line items such as energy, grid fees and taxes. Prepayment invoices (type: "prepayment") charge a fixed advance amount and carry no usage. The related PDFs are available via the /invoices/{id}/file endpoint.

​
object
enum<string>
required
Available options:
list
​
items
object[]
required
​
next_page
string | null
​
has_more
boolean
default:false