Skip to main content
POST
/
v1
/
meter
/
create
Create meter
curl --request POST \
  --url https://api.voltview.co.uk/v1/meter/create \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "siteId": 123,
  "mpxn": "<string>",
  "utilityType": "ELECTRICITY"
}
'
{
  "id": "<string>",
  "siteId": "<string>",
  "mpxn": "<string>",
  "utilityType": "ELECTRICITY",
  "meterSerialNumber": "<string>",
  "supplier": "<string>",
  "status": "ACTIVE",
  "createdAt": "2023-11-07T05:31:56Z"
}

Authorizations

Authorization
string
header
required

JWT token obtained from /v1/requestToken endpoint

Body

application/json
siteId
integer
required

ID of the site to add the meter to

mpxn
string
required

MPAN (13 digits for electricity) or MPRN (6-10 digits for gas)

utilityType
enum<string>
required

Type of utility

Available options:
ELECTRICITY,
GAS,
BMS

Response

Meter created successfully

id
string
required

Meter identifier

siteId
string
required

Associated site identifier

mpxn
string
required

MPAN (13 digits for electricity) or MPRN (6-10 digits for gas)

utilityType
enum<string>
required

Type of utility

Available options:
ELECTRICITY,
GAS,
BMS
meterSerialNumber
string

Meter serial number

supplier
string

Energy supplier name

status
enum<string>

Meter status

Available options:
ACTIVE,
INACTIVE
createdAt
string<date-time>

Creation timestamp