(v.2.1.0) Introducing Locations V2 and Tariffs V2 for AFIR compliance
š¹ 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
| Change | Endpoints | Description |
|---|---|---|
| Locations | GET /v2/locationsGET /v2/locations/{id} | - Format upgraded to OCPI 2.3.0 structure - Added data for facilities, opening hours, directions, contact information, and energy mix. |
| Tariffs | GET /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.