Skip to main content
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"
    }
  ],
  "next_page": "<string>",
  "has_more": false
}

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)

See Filtering Documentation for supported operators and syntax.

Example:

"value"

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
​
next_page
string | null
​
has_more
boolean
default:false