GET
/
invoices
/
{id}
curl --request GET \
  --url https://api.nomos.energy/invoices/{id} \
  --header 'Authorization: Bearer <token>'
{
  "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
}

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:

"inv_drjjua6ampd1op2fg98k89x8"

Response

200
application/json
Retrieve the invoice details
​
object
enum<string>
required
Available options:
invoice
​
id
string
required

Unique identifier of the invoice.

Example:

"inv_drjjua6ampd1op2fg98k89x8"

​
invoice_number
string
required

Human-readable invoice number displayed on the invoice document

Example:

"H62SU12A-003"

​
month
number
required

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

Example:

4

​
year
number
required

Four-digit year for which the invoice is issued

Example:

2025

​
period_start
string | null
required

Timestamp marking the beginning of the billing period (inclusive)

Example:

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

​
period_end
string | null
required

Timestamp marking the end of the billing period (exclusive)

Example:

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

​
period_number
number
required

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

Example:

3

​
status
enum<string>
required

Current status of the invoice:

Available options:
open,
paid,
voided
Example:

"open"

​
usage
number

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

Example:

100

​
total
number

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

Example:

110.04