---
title: "Search Meters"
method: GET
path: "/meter/search"
tags: ["2. Meters"]
---

# Search Meters

`GET /meter/search`

Search for all electricity meters in the vicinity of a given postcode/ 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 three steps:
1. Search for meters at the specified address using this endpoint
2. Ask the end-user to select the correct address from the list
3. Call the `/meter/by-ref/{meter_ref}` endpoint with the corresponding reference to get the full meter details

NB: This should not be used with procedural address matching; it is intended for end-user interaction only. For precise address matching, use the `/meter/by-address` endpoint instead, which will perform matching for you.

## 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`

List of meters matching the address; may be empty

- MeterSearchResponse[]
  - `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

## Other responses

- `422` — Invalid postcode or no meters found
- `500` — Something went wrong whilst processing the request
- `503` — Request to meter data provider failed
- `504` — Request to meter data provider timed out

---

[API](https://skmtc.dev/axle/apis/axle-api-docs.md) · [All operations](https://skmtc.dev/axle/apis/axle-api-docs/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/axle/axle-api-docs/revisions/75be7f9a952f/schema)