---
title: "Submit meter reading to supplier"
method: POST
path: "/v1/suppliers/accounts/{id}/readings"
tags: ["Supplier Integration"]
---

# Submit meter reading to supplier

`POST /v1/suppliers/accounts/{id}/readings`

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.

## Path parameters

- `id` string, required

## Request body

- SubmitMeterReadingToSupplierRequest
  - `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.
    - `registerId` string, required — Register ID from supplier meter details
    - `reading` number, required — Cumulative register value (non-negative integer)

## Response `200`

Meter reading submitted successfully to supplier

- object
  - `success` boolean
  - `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

## Other responses

- `400` — Bad request - invalid body, meter not found, or supplier rejected
- `500` — Failed to save reading to Firestore
- `4XX` — Client error response

---

[API](https://skmtc.net/voltview/apis/voltview-api.md) · [All operations](https://skmtc.net/voltview/apis/voltview-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/voltview/voltview-api/revisions/d90c739b55df/schema)