Skip to main content
POST
/
v1
/
suppliers
/
accounts
/
{id}
/
readings
curl --request POST \
  --url https://api.voltview.co.uk/v1/suppliers/accounts/{id}/readings \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "mpanMprn": "1234567890123",
  "readAt": "2026-03-15",
  "readings": [
    {
      "registerId": "reg-abc-001",
      "reading": 45231
    }
  ]
}
'
{
  "success": true,
  "message": "<string>",
  "readingId": "<string>",
  "data": {},
  "warning": "<string>"
}

Authorizations

Authorization
string
header
required

Supabase Auth JWT access token obtained after signing in via magic link or OTP

Path Parameters

id
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

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