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

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

x-api-key

string

header

required

VoltView API key

Path Parameters

string

required

Supplier account ID

Body

application/json

mpanMprn

string

required

MPAN (electricity) or MPRN (gas) for the meter

readAt

string

required

Date of the reading (ISO 8601 date e.g. 2026-03-15)

readings

object[]

required

One or more register readings. Get registerIds from the supplier account's meter details.

Minimum array length: 1

Show child attributes

Response

Meter reading submitted successfully to supplier

success

boolean

Example:

true

message

string

readingId

string

Unique id for this submission (for retries)

data

object

Supplier API response

warning

string

Optional e.g. readAt older than 10 days

Get Sites Associated with an Account Get Supplier Accounts for a Business

API Documentation

User

Sites

Meters

Emissions

Specific Site

Energy Consumption

Supplier Integration

LOA Management

Bill Validation

Submit meter reading to supplier

Authorizations

Path Parameters

Body

Response