2023-06-20

🚀 Feature

• Ability to filter Charges by partnerExternalId
• Ability to provide partnerExternalId and partnerCustomPayload when starting a Charge
• Expose new fields partnerExternalId and partnerCustomPayload for Charges
• New patch endpoint to update partnerExternalId and partnerCustomPayload for Charges
• New Endpoints to create and update the following entities:
  • Teams
  • Sites
  • Charge Points
• New Endpoints to fetch one or multiple:
  • Charge Point Connectors
  • Charge Point Brands
  • Charge Point Models
  • Countries

📝 Docs

• Fixed missing charge-points/maps query filters
• Added documentation with new endpoints:
  • Teams
  • Sites
  • Charge Points
  • Charge Point Connectors
  • Charge Point Brands
  • Charge Point Models
  • Countries

2023-05-02

🚀 Feature

• Added new Charge Point fields: brandName, modelName, firmwareVersion and integrationType
• Added new field partnerCustomPayload on the following entities:
  • Charge Point,
  • Charge Auth Token,
  • Charge Point,
  • Team
• New patch endpoint to update partnerExternalId and partnerCustomPayload for the following entities:
  • Charge Point,
  • Charge Auth Token,
  • Charge Point,
  • Team
• Added endpoints to fetch and list Team members.
• Ability to create Charge Auth Token assigned to a User.

🐛 Fix

• Removed legacy \chargeAuthTokens endpoint.

📝 Docs

• Updated Charge Point states.

2023-03-20

🚀 Feature

• Added new fields to Charge model: soc (State of Charge), socLimit and priceLimit
• Added new field to Charge Point model: cablePluggedIn - indicates if a cable is plugged in currently
• Added partnerExternalId to Charge Point, Site, Charge Auth Token and Team models
• Added query parameter partnerExternalId to filter by it on Charge Point, Site, Charge Auth Token and Team index endpoints

🚧

Beta

• Added endpoints to fetch Price Groups - this group of endpoints is subject to change in a near future release

2023-03-01

🐛 Fix

• ⚠️ Breaking change: Wallet transaction's field updated_at is optional

2023-02-01

❗️

New Base URL

The new base url for the Partner API is partner-api.monta.com

The previous one (partner-api.monta.app) is deprecated and will continue to work until 01.04.2023.

🚀 Feature

• Added support to create and delete Charge Auth Tokens
• Added support to fetch one or multiple Teams
• Added field operatorNote to Charge Point responses

🐛 Fix

• Renamed /chargeAuthTokens endpoint to /charge-auth-tokens
  request parameters and response payloads will remain the same,
  we will support both endpoints until at least 13-02-2023
  then we will effectively remove /chargeAuthTokens

📝 Docs

• Updated API documentation includes:
  • New endpoints to create and delete Charge Auth Tokens
  • New endpoints to fetch Teams
  • New Charge Point field
  • Instructions to migrate from the deprecated /chargeAuthTokens endpoint

2023-01-04

🚀 Feature

• Charges can now be filtered by the combined filter chargeAuthType and chargeAuthId
• New endpoints added to fetch one or multiple Charge Auth Token
• Added a new field lastMeterReadingKwh to Charge Point

📝 Docs

• Updated API documentation includes:
  • New endpoints to fetch Charge Auth Token
  • New Charge filters
  • New Charge Point field

🐛 Fix

• Endpoint /api/v1/me would not work with certain scopes
• Fetching a Wallet Transaction by id was not working

2022-12-14

🚀 Feature

• Filter Charges, Sites and Charge Points by teamId
• Wallet Transactions now have the createdAt and updatedAt fields
• New fields kwhPerHourand stopReason added to Charge, allowing you to retrieve information:
  • The total Kwh consumed for that charge, split by hour
  • The reason why the charge was stopped

📝 Docs

• Endpoints now also have the most important errors documented
• General cleanup of examples and descriptions to help auto-generate valid requests

2022-11-07

🚀 Feature

• New field chargeAuth added to Charge, allowing you to retrieve information about the authentication method used to authenticate the charge
• Charge, ChargePoint and Site now have the createdAt and updatedAt fields

🐛 Fix

• siteId query param of /api/v1/charge-points would allow for string values. This will now return a 400 - Bad Request if the value is not a number.

📝 Docs

• Update documentation for auth/me and pagination parameters.

2022-09-16

🚀 Feature

• Charge transactions can be filtered by fromDate and state
• Charge transactions are sorted by createdAt descending

⚠️ Breaking change

• Previously, the pagination page parameter would handle 0 and 1 equally but return an incorrect pagination meta data. Our Pagination page parameter was updated to start from 0. A page of 1 will now return the second page.

2022-09-14

🚀 Feature

• New endpoint added for reserving a Charge Point.

⚠️ Breaking change

• fromType and from on wallet transaction model is nullable now (e.g. for deposit transactions)
• toType and to on wallet transaction model is nullable now (e.g. for withdrawal transactions)

2022-07-06

🚀 Feature

• New map endpoint for Charge Points, allowing you to retrieve Clusters, Sites and Charge Points to be rendered on a map.
• Added field deeplinks to Charge Points. They allow you to start charging via Monta app or web app [no registration needed].
• Added auth scopes to credentials. Scope determines if you are eligible to access certain endpoints.

📝 Docs

• Update contact url in docs.

2022-06-13

🚀 Feature

• Rate-limit will be enforced from now on

⚠️ Breaking change

• staticMapUrl removed from Location model

2022-06-03

🧹 Chore

• Better error handling

2022-06-01

⚠️ Breaking change

• Rename Connector.slug to Connector.identifier
• Rename query param from/to to fromDate/toDate in wallet transactions

🐛 Fix

• Throw 401 instead of 404 when client credentials are wrong

📝 Docs

• Improve description for pagination parameters
• Add schema for TeamOrOperator
• Add enum values to all enum types
• Add security schemes