Skip to main content
POST
/
entities
/
site
/
initialise
Initialise Site
curl --request POST \
  --url https://api-sandbox.axle.energy/entities/site/initialise \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "site": {
    "mpan": "<string>",
    "postcode": "<string>",
    "street_address": "<string>",
    "email": "<string>",
    "gave_boundary_meter_consent_at": "2023-11-07T05:31:56Z"
  },
  "assets": [
    {
      "external_id": "<string>",
      "type": "charger",
      "properties": {
        "power_kw": 1,
        "capacity_kwh": 1
      },
      "asset_model": "<string>",
      "installation_date": "2023-12-25"
    }
  ]
}
'
{
  "site": {
    "site_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "site_created": true,
    "fields_updated": [
      "<string>"
    ],
    "warnings": [
      "<string>"
    ]
  },
  "assets": [
    {
      "asset_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "external_id": "<string>",
      "asset_created": true,
      "fields_updated": [
        "<string>"
      ],
      "warnings": [
        "<string>"
      ]
    }
  ],
  "eligibility": {
    "site_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "site_properties": {
      "is_half_hourly_settled": true,
      "has_meter_consent": true
    },
    "eligible_propositions": [],
    "assets": []
  }
}

Authorizations

Authorization
string
header
required

The access token received from the authorization server in the OAuth 2.0 flow.

Body

application/json

Request model for initialising a site with one or more assets.

Upserts the site and assets, returning eligibility information. No enrollment side effects (no dispatch consent, no bonus, no email).

site
Site · object
required

Site information

assets
OnboardingAssetRequest · object[]
required

One or more assets to register at the site

Response

Successfully initialised site and assets

Response model for the initialise endpoint.

site
Site · object
required

Site result metadata

assets
InitialiseAssetResult · object[]
required

Per-asset result metadata

eligibility
Eligibility · object
required

Eligibility information for the site and its assets