v1

latestOpenAPI 3.1.02026-07-264793109.1 KB
3. Sites

Create Site

Register a new site.

The site must have a valid address and postcode. If a site with the same address already exists, a 409 error will be returned with the existing site ID.

post/entities/site

Request body

mpanstring required

Meter Point Administration Number

postcodestring required

UK postcode for the site

street_addressstring

Street address for the site

emailstring

Email address for the site. Include to enable 2FA for payment withdrawals.

gave_boundary_meter_consent_atstring date-time

Timezone-aware ISO 8601 timestamp (e.g. '2026-01-01T12:34:56Z') indicating when the household gave consent for Axle to access readings from their boundary meter, if consent was given.

Response

Successful Response

idstring uuid required

Axle's internal UUID for the site

mpanstring

Meter Point Administration Number for the site

postcodestring

UK postcode for the site

addressstring

Full address for the site

asset_idsstring[]

List of asset IDs associated with this site

marketsMarketResponse[]

Markets the site is participating in

dispatch_methodsDispatchMethodResponse[]

Dispatch methods allowed for the site

gave_boundary_meter_consent_atstring date-time

Timestamp when boundary meter consent was given