v1

latestOpenAPI 3.0.3Proprietary2026-07-136748169.6 KB

Meters

Bulk meter lookup

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.

post/v1/meter/lookup/bulk

Request body

customerNamestring required

Name of the customer

Response

Bulk lookup results

mpanstring

MPAN for electricity meters (13 digits)

mprnstring

MPRN for gas meters (6-10 digits)

addressstring

Full address

postcodestring

Postcode

supplierstring

Current energy supplier

meterSerialNumberstring

Meter serial number

profileClassstring

Profile class code

eacnumber

Estimated Annual Consumption in kWh

aqnumber

Annual Quantity for gas meters in kWh