Changelog

šŸ”¹ What's New?

We've introduced Locations V2 and Tariffs V2 under the Spirii API.

The Charge Point Operator (CPO) of public chargers can use these GET endpoints to comply with the EU's Alternative Fuel Infrastructure Regulation (AFIR) article 20, which went into effect on April 14th, 2025.

Additionally, the added endpoints provide extended data fields related to location management and the pricing of public charging compared to the legacy Locations endpoint.

Both endpoints are structured and formatted in compliance with OCPI version 2.3.0.

šŸ“Œ New Endpoints:
GET /v2/locations
GET /v2/locations/{id}
GET /v2/tariffs/{id}


āŒ What's Deprecated?

The old Locations V1 endpoint is now deprecated under the Spirii Legacy API.

šŸ“Œ Deprecated Endpoints:
GET /locations
GET /locations/{id}

šŸ”” Action Required:
Partners using this endpoint should migrate to V2 as soon as possible.


šŸ”„ Key Changes & Improvements

ChangeEndpointsDescription
LocationsGET /v2/locations
GET /v2/locations/{id}
- Format upgraded to OCPI 2.3.0 structure
- Added data for facilities, opening hours, directions, contact information, and energy mix.
TariffsGET /v2/tariffs/{id} - Format upgraded to OCPI 2.3.0 structure
- Added data for tariff type, price components, and price restrictions

šŸ“¢ Migration & Next Steps

  • All partners using V1 should transition to V2 as soon as possible.
  • The V1 endpoint will remain operational for now, but will be fully sunset at a later date (to be announced).
  • If you use V1, please update your integrations accordingly and reach out if you need support.

šŸ“Œ Breaking Changes Notice:
Some properties are not available in the V2 anymore and the structure has changes in a breaking manner, but if you are using V1, we strongly recommend migrating now to take advantage of the new capabilities and ensure long-term compatibility. See the API documentation for the full details.


We fixed various bugs across the Transaction V2 and Voucher endpoints.

šŸ”„ Key Changes & Improvements

ChangeEndpointsDescription
Bug fixGET https://api.spirii.com/v2/transactions
GET https://api.spirii.com/v2/transactions/{id}
Fixed an issue with the startedAt filter not being applied
Bug fixGET https://api.spirii.com/vouchers
GET https://api.spirii.com/vouchers/{id}
Fixed an issue with retrieving voucher groups where the companyId was null
Bug fixGET https://api.spirii.com/vouchers
GET https://api.spirii.com/vouchers/{id}
Fixed an issue where the response included deleted voucher groups (deletedAt timestamp being populated). These are now filtered out.

šŸ”¹ What's New?

We've introduced Transaction V2 under the Spirii API.
This new version increases readability, introduces new transaction properties and improves the overall response structure and filtering capabilities.

šŸ“Œ New Endpoint:
GET /v2/transactions

šŸ“Œ New Endpoint:
GET /v2/transactions/{id}


āŒ What's Deprecated?

The old Transaction V1 endpoint is now deprecated under the Spirii Legacy API.

šŸ“Œ Deprecated Endpoint:
GET /v1/transactions

GET /v1/transactions/{id}

šŸ”” Action Required:
Partners using this endpoint should migrate to V2 as soon as possible.


šŸ”„ Key Changes & Improvements

ChangeTransaction V1Transaction V2
Data StructureN/AResponse structure changes:

- auth object has been added.
- location object now returns type, countryCode, isEligibleForRefund properties
- price object has been expanded to include VAT and tariff information
-user object has been replaced by appUserId
- chargingDetails has been added containing detailed charing information like charging status, state of charge meter start and stop values, and C02 emissions data
-company object has been added
- paymentStatus object has been added
-
Data StructuremeterValues object contains all meter values meterValues has been deprecated and replaced by meterStart and meterStop properties inside the chargingDetails object
PaginationOffset-based Cursor-based for better scalability
Filtering Limited filtering optionsEnhanced filtering based on multiple fields: ongoing ,chargeBoxId ,evseId,locationType ,transactionType ,voucherId

šŸ“¢ Migration & Next Steps

  • All partners using V1 should transition to V2 as soon as possible.
  • The V1 endpoint will remain operational for now, but will be fully sunset at a later date (to be announced).
  • If you use V1, please update your integrations accordingly and reach out if you need support.

šŸ“Œ Breaking Changes Notice:
Some properties are not available in the V2 anymore and the structure has changes in a breaking manner, but if you are using V1, we strongly recommend migrating now to take advantage of the new capabilities and ensure long-term compatibility. See the API documentation for the full details.


šŸ”¹ What's New?

We've introduced Charge Detail Records V2 under the Spirii API.
This new version enhances performance, consistency, and scalability while improving response structure and filtering capabilities.

šŸ“Œ New Endpoint:
GET /v2/charge-records


āŒ What's Deprecated?

The old Charge Record V1 endpoint is now deprecated under the Spirii Legacy API.

šŸ“Œ Deprecated Endpoint:
GET /v1/charge-records

šŸ”” Action Required:
Partners using this endpoint should migrate to V2 as soon as possible.


šŸ”„ Key Changes & Improvements

ChangeCharge Record V1Charge Record V2
Base Path/v1/charge-records/v2/charge-records
Data StructureFlattened response formatStructured response with nested data
FilteringLimited filtering optionsEnhanced filtering on multiple fields (e.g., start/end timestamps, CPO ID, EMP ID)
PaginationOffset-basedCursor-based for better scalability
Status FieldLimited status valuesExpanded status values for better charge session tracking
Meter ValuesBasic meter readingsMore detailed energy consumption metrics
TimestampsUnix timestampsISO 8601 format for consistency

šŸ“¢ Migration & Next Steps

  • All partners using V1 should transition to V2 as soon as possible.
  • The V1 endpoint will remain operational for now, but will be fully sunset at a later date (to be announced).
  • If you use V1, please update your integrations accordingly and reach out if you need support.

šŸ“Œ Breaking Changes Notice:
No immediate disruptions, but if you are using V1, we strongly recommend migrating now to take advantage of the new capabilities and ensure long-term compatibility.


For any questions or migration support, please reach out to support at [email protected].

Welcome to the developer hub and documentation for spirii!