Create a new Temporary EVSE Status

curl --request POST \
  --url https://api.spirii.com/v2/temporary-evse-statuses \
  --header 'Content-Type: application/json' \
  --data '
{
  "evseId": "DK*SPI*E123*1",
  "temporaryStatus": "MAINTENANCE",
  "validFrom": "2025-04-23T10:00:00Z",
  "validTo": "2025-04-23T18:00:00Z"
}
'

{
  "id": 42,
  "temporaryStatus": "MAINTENANCE",
  "evseId": "DK*SPI*E123*1",
  "validFrom": "2023-01-01T12:00:00Z",
  "validTo": "2023-01-01T14:00:00Z"
}

Create a new Temporary EVSE Status

This API enables you, the Charge Point Operator (CPO)—the owners of chargers and EVSE, data—to temporarily override the displayed status of an EVSE (Electric Vehicle Supply Equipment) in e-mobility apps, without affecting its underlying technical or operational state.

We refer to this as a Temporary EVSE Status. It is designed for scenarios where an EVSE should not be used by customers for a limited period, such as during maintenance, commissioning, reservation, or temporary blocking, but where the EVSE itself remains technically operational.

Key Distinction: Technical vs. Displayed (POI) Status

Technical EVSE Status:
The actual operational state of the EVSE, as reported by the charger using protocols like OCPP (e.g., Available, Charging, Faulted). This status reflects the real-time condition and capabilities of the hardware.
POI (Point of Interest) EVSE Status:
The status shown to end-users in apps and roaming platforms. This can be overridden by this API to communicate temporary unavailability or special conditions, regardless of the technical status.

This API only affects the POI status. Communication with the charger and its technical state (OCPP status) remain unchanged.

Intended Use Cases

Maintenance: Mark an EVSE as unavailable to users while it is being serviced, even if technically operational.
Commissioning: Indicate that an EVSE is being set up or tested and not yet open for public use.
Blocking: Temporarily prevent usage due to faults, safety concerns, or other operational reasons.
Reservation: Show that an EVSE is reserved for a specific user or time period.

Status Mapping Across Protocols

When a Temporary EVSE Status is set, it is mapped to the corresponding display status in Spirii’s app and major roaming platforms as follows:

Temporary Status	Spirii Go App	Hubject (Roaming)	OCPI (Roaming)
Maintenance	Unavailable	Out of Service	Inoperative
Commissioning	Coming Soon	Out of Service	Planned
Blocked	Blocked	Occupied	Blocked
Reserved	Reserved	Reserved	Reserved

Note: External eMSP (e-mobility service provider) apps may not reflect status changes immediately, as their update intervals can vary.

Once you create a Temporary EVSE Status, you receive a unique resource ID. This ID allows you to update (PATCH) the status (e.g., change the type or adjust the validFrom/validTo dates) or delete it to revert the EVSE back to its technical status. In other words, this is a full CRUD resource for managing temporary display statuses.

POST

temporary-evse-statuses

Create a new Temporary EVSE Status

curl --request POST \
  --url https://api.spirii.com/v2/temporary-evse-statuses \
  --header 'Content-Type: application/json' \
  --data '
{
  "evseId": "DK*SPI*E123*1",
  "temporaryStatus": "MAINTENANCE",
  "validFrom": "2025-04-23T10:00:00Z",
  "validTo": "2025-04-23T18:00:00Z"
}
'

{
  "id": 42,
  "temporaryStatus": "MAINTENANCE",
  "evseId": "DK*SPI*E123*1",
  "validFrom": "2023-01-01T12:00:00Z",
  "validTo": "2023-01-01T14:00:00Z"
}

Body

application/json

evseId

string

required

Reference to the EVSE ID

Example:

"DK*SPI*E123*1"

temporaryStatus

enum<string>

required

Temporary EVSE status property.

Use Cases  
- MAINTENANCE: Use this status when an EVSE is undergoing maintenance and should not be used by customers.  
- COMMISSIONING: Use this status for EVSEs that are being set up or tested and are not yet ready for public use.  
- BLOCKED: Use this status to temporarily prevent an EVSE from being used, for example, due to a fault or safety concern.  
- RESERVED: Use this status to indicate that an EVSE is reserved for a specific user or time period.

Available options:

MAINTENANCE,

COMMISSIONING,

BLOCKED,

RESERVED

Example:

"MAINTENANCE"

validFrom

string

Start date and time of the Temporary EVSE Status. If unset, the current date and time will be used.

Example:

"2025-04-23T10:00:00Z"

validTo

string

End date and time of the Temporary EVSE Status. If unset, the temporary status will ramain until removed.

Example:

"2025-04-23T18:00:00Z"

Response

number

required

The unique identifier for the Temporary EVSE Status

Example:

42

temporaryStatus

enum<string>

required

Status of the Temporary EVSE Status

Available options:

MAINTENANCE,

COMMISSIONING,

BLOCKED,

RESERVED

Example:

"MAINTENANCE"

evseId

string

required

The EVSE ID

Example:

"DK*SPI*E123*1"

validFrom

string

The start date and time of the Temporary EVSE Status

Example:

"2023-01-01T12:00:00Z"

validTo

string

The end date and time of the Temporary EVSE Status

Example:

"2023-01-01T14:00:00Z"

Get all Temporary EVSE Statuses

Get a Temporary EVSE Status by ID