curl --request POST \
--url https://api.voltview.co.uk/v1/suppliers/accounts/{id}/readings \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"mpanMprn": "1234567890123",
"readAt": "2026-03-15",
"readings": [
{
"registerId": "reg-abc-001",
"reading": 45231
}
]
}
'{
"success": true,
"message": "<string>",
"readingId": "<string>",
"data": {},
"warning": "<string>"
}{
"success": false,
"message": "<string>",
"readingId": "<string>",
"error": "<string>",
"warning": "<string>"
}{
"success": false,
"message": "<string>",
"readingId": "<string>"
}{
"type": "error",
"error": {
"type": "invalid_request_error",
"message": "Invalid request"
}
}Supplier Integration
Submit meter reading to supplier
Submit a meter reading to the supplier (Octopus Energy, E.ON Next, British Gas Lite). The reading is saved to Firestore with status PENDING first, then sent to the supplier; the document is updated to SUCCESS or FAILED. Supports single-register (gas or single-rate electricity), day/night (2 registers), or multi-register (e.g. green/amber/red). Get registerIds from the supplier account’s meter details (e.g. from account sites). On failure, the response includes readingId so you can retry within the typical 10-day submission window.
POST
/
v1
/
suppliers
/
accounts
/
{id}
/
readings
curl --request POST \
--url https://api.voltview.co.uk/v1/suppliers/accounts/{id}/readings \
--header 'Content-Type: application/json' \
--header 'x-api-key: <api-key>' \
--data '
{
"mpanMprn": "1234567890123",
"readAt": "2026-03-15",
"readings": [
{
"registerId": "reg-abc-001",
"reading": 45231
}
]
}
'{
"success": true,
"message": "<string>",
"readingId": "<string>",
"data": {},
"warning": "<string>"
}{
"success": false,
"message": "<string>",
"readingId": "<string>",
"error": "<string>",
"warning": "<string>"
}{
"success": false,
"message": "<string>",
"readingId": "<string>"
}{
"type": "error",
"error": {
"type": "invalid_request_error",
"message": "Invalid request"
}
}Authorizations
VoltView API key
Path Parameters
Supplier account ID
Body
application/json