Skip to main content
GET
/
v1
/
meters
/
{meterId}
/
reads
Get meter reads
curl --request GET \
  --url https://api.voltview.co.uk/v1/meters/{meterId}/reads \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": "<string>",
    "meterId": "<string>",
    "readValue": 123,
    "readDate": "2023-11-07T05:31:56Z",
    "readType": "ACTUAL",
    "registerCode": "TOTAL",
    "source": "MANUAL",
    "notes": "<string>",
    "createdAt": "2023-11-07T05:31:56Z"
  }
]

Authorizations

​
Authorization
string
header
required

JWT token obtained from /v1/requestToken endpoint

Path Parameters

​
meterId
string
required

UUID of the meter

Query Parameters

​
fromDate
string<date-time>

Start date filter (ISO date string)

​
toDate
string<date-time>

End date filter (ISO date string)

​
registerCode
enum<string>

Filter by register code

Available options:
TOTAL,
DAY,
NIGHT,
PEAK,
OFF_PEAK
​
limit
integer
default:100

Number of records to return (max 1000)

Required range: x <= 1000
​
offset
integer
default:0

Offset for pagination

Response

Meter reads retrieved successfully

​
id
string
required

Meter read identifier

​
meterId
string
required

Associated meter identifier

​
readValue
number
required

Meter reading value

​
readDate
string<date-time>
required

Date of the reading

​
readType
enum<string>
required

Type of reading

Available options:
ACTUAL,
ESTIMATED,
CUSTOMER
​
registerCode
enum<string>

Register code

Available options:
TOTAL,
DAY,
NIGHT,
PEAK,
OFF_PEAK
​
source
enum<string>

Source of the reading

Available options:
MANUAL,
INVOICE,
SMART_METER,
SUPPLIER_API
​
notes
string

Additional notes

​
createdAt
string<date-time>

Creation timestamp