🚀 Feature

• Added new endpoint /charge-points/{chargePointId}/logs to retrieve OCPP logs for a specific charge point
• We are exposing RateLimit headers now. Details here
• Added Charge Point Statistics API for retrieving statistics related to a given charge point or charge points in a site
• Added simCard related data to Charge Points model
• Added roaming flag to Charge Points model
• Added lastConnectedAt and disconnectedAt fields to Charge Points model
• Added functionality to accept requests for Team Members join team request
• Introduced an API for managing nested teams
• Added amount field to Charges genenericPaymentSession this field can be set via PATCH endpoint.
• Added eventTime field for Webhooks. This field captures the timestamp at which the event was generated by our systems. this field has milliseconds precision.

📝 Docs

• We added a new Guide around Charge States

🐛 Fix

• Improved performance on wallet transaction endpoint

🚀 Feature

• Add new endpoints to get reports by filters or a report by id
  • GET api/v1/reports
  • GET api/v1/reports/{reportId}
• Add new webhook event type for Reports (reports)
• Add new webhook event type for Users (users)

v2024-07-01

• Adding support for price forecasts on Public Charge Points
• Added the ability to start a charge on a Public Charge Point

🚀 Feature

• Add endpoints to freeze / unfreeze Teams
• New endpoint to get Wallet Transactions by invoiceId /wallet-transactions/invoices/{invoiceId}
• New endpoints to manage and apply Team Member Profiles
• Add new webhook event type for Users (users)

v2024-07-01

📘

Version 2024-07-01 was soft-launched as Beta.

It will introduce more Fleet API features, more performant endpoints as well as support for dealing with multiple versions gracefully.

🚀 Feature

• Adding support for graceful API versioning
• Adding support for retrieving Public Charge Points
• Adding support for retrieving Public Sites

🚀 Feature

• Added new Insights endpoint to retrieve driver report with Team Member Cost Groups
• Add new webhook event type for Charge Auth Tokens (charge-auth-tokens)
• Wallet Transactions: Added field completedAt
• New endpoint to get invoices by id /invoices/{invoiceId}
• New endpoint to get list of invoices by wallet id as a query parameter /invoices?walletId=123
• Added new endpoints to retrieve Users that are part of your whitelable application

🚀 Feature

• Added releasedAt field to Charge model
• Added fromSubAmount, fromVatAmount, toSubAmount and toVatAmount to Wallet Transactions

🚀 Feature

• Updates to Charge Keys:
  • PATCH endpoint allows setting activeUntil
  • New endpoints added to block / unblock a Charge Key
• Update to Insights > Driver Report: you can provide wether the report is based on wallet transactions completedAt or charge transactions completedAt date (default)

🐛 Fix

• Generic Payment Sessions no longer require cardLast4 to be present to be persisted. For now, we persist in any Generic Payment Session that has any field filled in. Very soon will make it a requirement to provide at least one provider and externalId
• Generic Payment Sessions require the fields provider and externalId to be provided.
• Fixed a couple of fields that were not mapped correctly on the Tariffs response
• The vat flag was not applied correctly to spot fees.

🚀 Feature

• New endpoint for Wallets:
  • GET /wallets allows you to retrieve wallets for your operator or team
  • GET /wallets/:id returns a specific wallet by id
  • We also added fromWalletId and toWalletId fields to Wallet Transactions
• Updates to Charge Keys:
  • PATCH endpoint allows setting activeUntil
  • New endpoints added to block / unblock a Charge Key

🚀 Feature

• Added vatNumber to Teams model

🚀 Feature

• Sponsored Charge Points - added new fields to chargePoint object:
  • chargePointModelId
  • brandName
  • modelName
  • firmwareVersion
  • maxKw
  • isActive
• Added new Price Group Tags APIs - they allow you to assign tags to price group elements (charge pricings).
  • GET /price-group-tags - Retrieve your operators' tags
  • GET /price-group-tags/:id - Retrieve a tag by id
  • POST /price-group-tags - Create a new tag
  • PATCH /price-group-tags/:id - Update an existing tag
  • DELETE /price-group-tags/:id - Delete a tag
    Note: tags are scoped at operator level, so they can be used across an operator.
• Price Group Tags are exposed on Charge Breakdowns
• Price Group Tags can be assigned when creating Price Groups
• Charges contain a new object publicChargePoint. This gives you public information about the charge point, such as EVSE ID, address, brand, and model.
• You can include deleted entries for Sponsored Charge Points in GET /api/v1/sponsored-charge-points
• Added field completedAt and chargePointOperatorName for Charges
• Added reservable and reservationTime for Charge Points

🐛 Fix

• Deleted Team Members are retrievable via GET /api/v1/team-members/{id}

🚀 Feature

• Added field startSource on the Charges response, the full dictionary of types and descriptions can be found here
• Added endpoints to create, update and delete Sponsored Charge Points, endpoints and request/response objects can be found here.
• New endpoint for Prices Forecast /prices/forecast, this endpoint will enable partners to forecast prices for a given Charge Point and Price Group
• Added new Insights APIs - they are replacing the Charges Insights APIs:
  • /insights/charges/charger-report: Returns a list of charge points (owned by given teamId) with the number of charging sessions and the total Kwhs consumed.
  • /insights/charges/driver-report: Returns charge insights for the given teamId (and optionally teamMemberIds) broken down by team member.
    Takes only charges into consideration that were paid for by the provided teamId.

📝 Docs

• We have added a new field x-sunset which specifies the date for removal on all deprecated fields / endpoints. Any field or endpoint that was announced to be removed already or soon was updated for removal by 01.04.2024 to give you more time to validate your integrations.

🐛 Fix

• Generic Payment Sessions no longer require cardLast4 to be present to be persisted. For now, we persist in any Generic Payment Session that has any field filled in. Very soon will make it a requirement to provide at least one provider and externalId

🚧

Deprecation Note

• We have deprecated Charges Insights APIs (/charges/insights). They will be removed by 01.04.24. Moving forward make use of the new Insights APIs.

🚧

Beta

The /prices/forecastis currently in BETA phase, changes and might be subject to change in a near future release