Create a TENANT sub-network

curl --request POST \
  --url https://api.spirii.com/emsp/v1/networks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "name": "<string>",
  "parent_network_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "cpo_ids": [
    "<string>"
  ],
  "description": "<string>",
  "countries": [
    "<string>"
  ],
  "power_types": [
    "<string>"
  ],
  "parking_types": [
    "<string>"
  ],
  "facilities": [
    "<string>"
  ],
  "auto_accept_cpo_additions": false,
  "publicly_accessible": false
}
'

import requests

url = "https://api.spirii.com/emsp/v1/networks"

payload = {
    "name": "<string>",
    "parent_network_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "cpo_ids": ["<string>"],
    "description": "<string>",
    "countries": ["<string>"],
    "power_types": ["<string>"],
    "parking_types": ["<string>"],
    "facilities": ["<string>"],
    "auto_accept_cpo_additions": False,
    "publicly_accessible": False
}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: '<string>',
    parent_network_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    cpo_ids: ['<string>'],
    description: '<string>',
    countries: ['<string>'],
    power_types: ['<string>'],
    parking_types: ['<string>'],
    facilities: ['<string>'],
    auto_accept_cpo_additions: false,
    publicly_accessible: false
  })
};

fetch('https://api.spirii.com/emsp/v1/networks', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.spirii.com/emsp/v1/networks",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'parent_network_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    'cpo_ids' => [
        '<string>'
    ],
    'description' => '<string>',
    'countries' => [
        '<string>'
    ],
    'power_types' => [
        '<string>'
    ],
    'parking_types' => [
        '<string>'
    ],
    'facilities' => [
        '<string>'
    ],
    'auto_accept_cpo_additions' => false,
    'publicly_accessible' => false
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "Idempotency-Key: <idempotency-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.spirii.com/emsp/v1/networks"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"parent_network_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"cpo_ids\": [\n    \"<string>\"\n  ],\n  \"description\": \"<string>\",\n  \"countries\": [\n    \"<string>\"\n  ],\n  \"power_types\": [\n    \"<string>\"\n  ],\n  \"parking_types\": [\n    \"<string>\"\n  ],\n  \"facilities\": [\n    \"<string>\"\n  ],\n  \"auto_accept_cpo_additions\": false,\n  \"publicly_accessible\": false\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Idempotency-Key", "<idempotency-key>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.spirii.com/emsp/v1/networks")
  .header("Idempotency-Key", "<idempotency-key>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"parent_network_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"cpo_ids\": [\n    \"<string>\"\n  ],\n  \"description\": \"<string>\",\n  \"countries\": [\n    \"<string>\"\n  ],\n  \"power_types\": [\n    \"<string>\"\n  ],\n  \"parking_types\": [\n    \"<string>\"\n  ],\n  \"facilities\": [\n    \"<string>\"\n  ],\n  \"auto_accept_cpo_additions\": false,\n  \"publicly_accessible\": false\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.spirii.com/emsp/v1/networks")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Idempotency-Key"] = '<idempotency-key>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"parent_network_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"cpo_ids\": [\n    \"<string>\"\n  ],\n  \"description\": \"<string>\",\n  \"countries\": [\n    \"<string>\"\n  ],\n  \"power_types\": [\n    \"<string>\"\n  ],\n  \"parking_types\": [\n    \"<string>\"\n  ],\n  \"facilities\": [\n    \"<string>\"\n  ],\n  \"auto_accept_cpo_additions\": false,\n  \"publicly_accessible\": false\n}"

response = http.request(request)
puts response.read_body

{
  "network_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "network_type": "BASE",
  "published": true,
  "publish_state": "PUBLISHED",
  "unpublish_started_at": "2023-11-07T05:31:56Z",
  "unpublish_drain_until": "2023-11-07T05:31:56Z",
  "tenant_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "emp_identity_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "description": "<string>",
  "cpo_ids": [
    "<string>"
  ],
  "protocol": [
    "<string>"
  ],
  "roaming_hub": [
    "<string>"
  ],
  "publicly_accessible": true,
  "parent_network_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "countries": [
    "<string>"
  ],
  "power_types": [
    "<string>"
  ],
  "parking_types": [
    "<string>"
  ],
  "facilities": [
    "<string>"
  ],
  "auto_accept_cpo_additions": true,
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

Create a TENANT sub-network

Creates a named slice of a base network — for example “Fleet fast chargers” or “Premium partners” — which you can then assign to a group of charging tokens so those drivers see only these operators. The operators you pick must all be part of the chosen parent network. Supply an idempotency key to prevent duplicate creation on retry. If the parent network is in the middle of being withdrawn from publication, new slices of it cannot be created.

POST

emsp

networks

curl --request POST \
  --url https://api.spirii.com/emsp/v1/networks \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "name": "<string>",
  "parent_network_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "cpo_ids": [
    "<string>"
  ],
  "description": "<string>",
  "countries": [
    "<string>"
  ],
  "power_types": [
    "<string>"
  ],
  "parking_types": [
    "<string>"
  ],
  "facilities": [
    "<string>"
  ],
  "auto_accept_cpo_additions": false,
  "publicly_accessible": false
}
'

import requests

url = "https://api.spirii.com/emsp/v1/networks"

payload = {
    "name": "<string>",
    "parent_network_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "cpo_ids": ["<string>"],
    "description": "<string>",
    "countries": ["<string>"],
    "power_types": ["<string>"],
    "parking_types": ["<string>"],
    "facilities": ["<string>"],
    "auto_accept_cpo_additions": False,
    "publicly_accessible": False
}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: '<string>',
    parent_network_id: '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    cpo_ids: ['<string>'],
    description: '<string>',
    countries: ['<string>'],
    power_types: ['<string>'],
    parking_types: ['<string>'],
    facilities: ['<string>'],
    auto_accept_cpo_additions: false,
    publicly_accessible: false
  })
};

fetch('https://api.spirii.com/emsp/v1/networks', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.spirii.com/emsp/v1/networks",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_POSTFIELDS => json_encode([
    'name' => '<string>',
    'parent_network_id' => '3c90c3cc-0d44-4b50-8888-8dd25736052a',
    'cpo_ids' => [
        '<string>'
    ],
    'description' => '<string>',
    'countries' => [
        '<string>'
    ],
    'power_types' => [
        '<string>'
    ],
    'parking_types' => [
        '<string>'
    ],
    'facilities' => [
        '<string>'
    ],
    'auto_accept_cpo_additions' => false,
    'publicly_accessible' => false
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json",
    "Idempotency-Key: <idempotency-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.spirii.com/emsp/v1/networks"

	payload := strings.NewReader("{\n  \"name\": \"<string>\",\n  \"parent_network_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"cpo_ids\": [\n    \"<string>\"\n  ],\n  \"description\": \"<string>\",\n  \"countries\": [\n    \"<string>\"\n  ],\n  \"power_types\": [\n    \"<string>\"\n  ],\n  \"parking_types\": [\n    \"<string>\"\n  ],\n  \"facilities\": [\n    \"<string>\"\n  ],\n  \"auto_accept_cpo_additions\": false,\n  \"publicly_accessible\": false\n}")

	req, _ := http.NewRequest("POST", url, payload)

	req.Header.Add("Idempotency-Key", "<idempotency-key>")
	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.post("https://api.spirii.com/emsp/v1/networks")
  .header("Idempotency-Key", "<idempotency-key>")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"name\": \"<string>\",\n  \"parent_network_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"cpo_ids\": [\n    \"<string>\"\n  ],\n  \"description\": \"<string>\",\n  \"countries\": [\n    \"<string>\"\n  ],\n  \"power_types\": [\n    \"<string>\"\n  ],\n  \"parking_types\": [\n    \"<string>\"\n  ],\n  \"facilities\": [\n    \"<string>\"\n  ],\n  \"auto_accept_cpo_additions\": false,\n  \"publicly_accessible\": false\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.spirii.com/emsp/v1/networks")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Post.new(url)
request["Idempotency-Key"] = '<idempotency-key>'
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"name\": \"<string>\",\n  \"parent_network_id\": \"3c90c3cc-0d44-4b50-8888-8dd25736052a\",\n  \"cpo_ids\": [\n    \"<string>\"\n  ],\n  \"description\": \"<string>\",\n  \"countries\": [\n    \"<string>\"\n  ],\n  \"power_types\": [\n    \"<string>\"\n  ],\n  \"parking_types\": [\n    \"<string>\"\n  ],\n  \"facilities\": [\n    \"<string>\"\n  ],\n  \"auto_accept_cpo_additions\": false,\n  \"publicly_accessible\": false\n}"

response = http.request(request)
puts response.read_body

{
  "network_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "name": "<string>",
  "network_type": "BASE",
  "published": true,
  "publish_state": "PUBLISHED",
  "unpublish_started_at": "2023-11-07T05:31:56Z",
  "unpublish_drain_until": "2023-11-07T05:31:56Z",
  "tenant_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "emp_identity_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "description": "<string>",
  "cpo_ids": [
    "<string>"
  ],
  "protocol": [
    "<string>"
  ],
  "roaming_hub": [
    "<string>"
  ],
  "publicly_accessible": true,
  "parent_network_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "countries": [
    "<string>"
  ],
  "power_types": [
    "<string>"
  ],
  "parking_types": [
    "<string>"
  ],
  "facilities": [
    "<string>"
  ],
  "auto_accept_cpo_additions": true,
  "created_at": "2023-11-07T05:31:56Z",
  "updated_at": "2023-11-07T05:31:56Z"
}

Authorizations

Authorization

string

header

required

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

Headers

Idempotency-Key

string<uuid>

required

Client-generated unique key per operation intent (UUID). Same key + identical body replays the original response; same key + different body returns 409.

Body

application/json

name

string

required

Maximum string length: 255

parent_network_id

string<uuid>

required

Parent BASE network ID

cpo_ids

string[]

required

Operator IDs of CPOs belonging to this sub network

description

string

Maximum string length: 1000

countries

string[]

Countries covered by this sub network

power_types

string[]

Power types available in this sub network

parking_types

string[]

Parking types available in this sub network

facilities

string[]

Facilities available in this sub network

auto_accept_cpo_additions

boolean

default:false

When true, cpo_ids added to the parent BASE network are automatically added to this sub network.

publicly_accessible

boolean

default:false

When true, this sub network's locations appear in anonymous location discovery.

Response

The created sub-network. Fires network.created webhook.

network_id

string<uuid>

required

Network identifier.

name

string

required

BASE network name (auto-derived from the emp_identity and immutable) or the creator-set SUB network name.

network_type

enum<string>

required

Network kind.

Available options:

BASE,

SUB

published

boolean

required

Whether a BASE network is currently published. Always false for SUB networks.

publish_state

enum<string> | null

required

Publish lifecycle state for BASE networks; null for SUB networks.

Available options:

PUBLISHED,

UNPUBLISHED,

UNPUBLISHING

unpublish_started_at

string<date-time> | null

required

When the current unpublish (drain) was started, if any.

unpublish_drain_until

string<date-time> | null

required

When the unpublish drain window ends, after which the network is fully unpublished.

tenant_id

string<uuid>

required

Owning tenant identifier.

emp_identity_id

string<uuid>

required

emp_identity the network belongs to.

description

string | null

required

Free-text description.

cpo_ids

string[]

required

Operator IDs (eMI3, e.g. DK*SPI) of the CPOs in this network.

protocol

string[]

required

Roaming protocols carried by the network.

roaming_hub

string[]

required

Roaming hubs the network is reachable through.

publicly_accessible

boolean

required

Whether the network is publicly accessible.

parent_network_id

string<uuid> | null

required

Parent BASE network for a SUB network; null for BASE networks.

countries

string[]

required

ISO 3166-1 country codes the network covers.

power_types

string[]

required

Power types the network filters on.

parking_types

string[]

required

Parking types the network filters on.

facilities

string[]

required

Facilities the network filters on.

auto_accept_cpo_additions

boolean

required

Whether newly-available CPOs are auto-accepted into the network.

created_at

string<date-time>

required

Creation timestamp (UTC).

updated_at

string<date-time>

required

Last-update timestamp (UTC).

Get started

Spirii API

EMSP API

Billing API

Energy Management API

Legacy API

Create a TENANT sub-network

Authorizations

Headers

Body

Response