---
title: "Bulk meter lookup"
method: POST
path: "/v1/meter/lookup/bulk"
tags: ["Meters"]
---

# Bulk meter lookup

`POST /v1/meter/lookup/bulk`

Look up multiple meters at once for a specific customer. Maximum 50 lookups per request. Efficiently uses cache to avoid repeat API calls. Requires hasMeterLookup permission.

## Request body

- object
  - `customerName` string, required — Name of the customer
  - `lookups` object[], required
    - `addressId` string, required — Address ID or MPAN/MPRN
    - `fuelType` 'electricity' | 'gas', required — Fuel type

## Response `200`

Bulk lookup results

- MeterDetails[]
  - `mpan` string — MPAN for electricity meters (13 digits)
  - `mprn` string — MPRN for gas meters (6-10 digits)
  - `address` string — Full address
  - `postcode` string — Postcode
  - `supplier` string — Current energy supplier
  - `meterSerialNumber` string — Meter serial number
  - `profileClass` string — Profile class code
  - `eac` number — Estimated Annual Consumption in kWh
  - `aq` number — Annual Quantity for gas meters in kWh

## Other responses

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