Meters

Search meters

Search for electricity meters at a specific address.

This endpoint allows searching for meters by postcode and optionally by building identifier. For data protection and contractual reasons, meter details are returned in an encrypted format that can be used in subsequent API calls to retrieve the full meter information.

The search works in two steps:

Search for meters at the specified address using this endpoint
Call the /meter/by-ref/ endpoint with the returned reference to get the full meter details.

GET

meter

curl --request GET \
  --url http://localhost:8002/meter/search \
  --header 'Authorization: Bearer <token>'

[
  {
    "ref": "<string>",
    "address": "<string>"
  }
]

Authorizations

Authorization

string

header

required

The access token received from the authorization server in the OAuth 2.0 flow.

Query Parameters

postcode

string

required

Postcode at which the requested meter is registered

building_identifier

string

House number or house/building name, e.g. '3', '10A', 'Flat 4', 'The Old Barn'

Response

200

application/json

List of meters matching the address

ref

string

required

Encrypted reference to the meter that can be used in subsequent API calls

address

string

required

Full address where the meter is registered

Get meter info by MPANRetrieve detailed information about a meter using its MPAN. This endpoint allows direct lookup of meter information when the MPAN is already known.

curl --request GET \
  --url http://localhost:8002/meter/search \
  --header 'Authorization: Bearer <token>'

[
  {
    "ref": "<string>",
    "address": "<string>"
  }
]

API Documentation

Authorizations

Query Parameters

Response