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 https://api-sandbox.axle.energy/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

The response is of type MeterSearchResponse · object[].

curl --request GET \
  --url https://api-sandbox.axle.energy/meter/search \
  --header 'Authorization: Bearer <token>'

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

API Documentation

Authorizations

Query Parameters

Response