Skip to main content
GET
/
subscriptions
/
{id}
/
meter_readings
Get all meter readings
curl --request GET \
  --url https://api.nomos.energy/subscriptions/{id}/meter_readings \
  --header 'Authorization: Bearer <token>'
{
  "object": "list",
  "items": [
    {
      "object": "meter_reading",
      "id": "mr_rocbrf1u5e48mm0reeqoag90",
      "customer": "cus_a8n8ol7yd4h0wohx824f0bui",
      "subscription": "sub_rocbrf1u5e48mm0reeqoag90",
      "meter": "mtr_azk4zue2ijx4ff1dbjt14m5h",
      "value": 150,
      "timestamp": "2023-11-07T05:31:56Z",
      "type": "customer_report",
      "created_at": "2023-11-07T05:31:56Z"
    }
  ],
  "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_ig1f5x45789r3ax7dlfff4q4"

Query Parameters

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

Filterable fields:

  • type (string)
  • created_at (date)

See Filtering Documentation for supported operators and syntax.

Example:

"value"

Response

Retrieve all meter readings for a subscription with cursor pagination

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