# Changelog

<!-- entries:start - newest first; the changelog review workflow inserts new entries right below this line -->

## 2026-10-22

### 🚀 Features
- Expose saved payment methods on teams and users [docs](/api/teams#retrieve-a-team)
- Expose `customFields` on teams [docs](/api/teams#retrieve-a-team)
- Move a meter to another node [docs](/api/energy-sites#update-a-node)
- Add site change-log count endpoint [docs](/api/energy-change-log#get-settings-change-log-for-a-site)
- Set team charge intents on sites [docs](/api/energy-charge-intents#set-manual-charge-intent-for-an-active-charge-session)
- List vehicles across sites [docs](/api/vehicles#retrieve-a-list-of-vehicles)
- Add paged search for energy sites [docs](/api/energy-sites#get-all-sites)
- Clear an EVSE's charge intent [docs](/api/energy-charge-intents#delete-rfid-charge-intent)
- Set a node's power-limit schedule [docs](/api/energy-sites#set-a-temporary-power-limit-on-a-node)
- Move an EVSE to another node [docs](/api/energy-sites#update-an-evse)
- Set charge intents for site users [docs](/api/energy-charge-intents#set-rfid-charge-intent)
### 🔧 Fixes
- Prevent slow webhook consumers from blocking delivery cycle
- Improve webhook entry claiming performance
### ⚠️ Deprecations
- Deprecate legacy team field pair in favor of `customFields` [docs](/api/teams#retrieve-a-team)

## 2026-10-22

### 🚀 Features
- Expose saved payment methods on teams and users

## 2026-10-15

### 🚀 Features
- Add Perific digital-input configuration
- Expose alerts and issues read endpoints
### 🔧 Fixes
- Fix comment-only deeplink PATCH [docs](/api/deeplinks#patch-an-existing-deeplink)
- Align energy vehicle model with service-energy

## 2026-10-15

### 🚀 Features
- Add `financeCommunicationEmail` field to team and operator endpoints [docs](/api/teams#create-a-team)
- Add Shelly meter integration endpoints [docs](/api/energy-monitoring)
- Return meter-specific properties on site detail [docs](/api/sites#retrieve-a-single-charge-site)
- Expose `countrySubdivisionCode` on sites, charge points, and teams [docs](/api/sites#retrieve-your-charge-sites)
- Rename charge-key inventory to charge auth token inventory and add `includeDeleted` filter [docs](/api/charge-auth-tokens#retrieve-list-of-charge-auth-tokens)
- Accept `autoRegisterRfid` on charge point create and return in v2 [docs](/api/charge-points#create-a-charge-point)
### 🔧 Fixes
- Forward tariff recurring period minutes to grid-data [docs](/api/tariff-recurring-periods#retrieve-recurring-periods)
- Document 403 response for deeplinks without an operator [docs](/api/deeplinks#retrieve-a-list-of-deeplinks)
- Keep omitted site settings on partial update [docs](/api/sites#patch-an-existing-charge-site)
- Read `vat_from_amount` in v2 wallet transactions list [docs](/api/wallet-transactions#retrieve-your-wallet-transactions)
- Declare response schema on POST create endpoints [docs](/api/teams#create-a-team)
- Clarify when `fullyChargedAt` is set [docs](/api/charges#retrieve-a-single-charge)
- Document node external power limit semantics [docs](/api/energy-sites#set-a-temporary-power-limit-on-a-node)

## 2026-10-15

- Document when `fullyChargedAt` is set [docs](/api/charges#retrieve-a-single-charge)
- Document 403 response for deeplinks without an operator [docs](/api/deeplinks#retrieve-a-single-deeplink)

## 2026-10-06

### 🚀 Features
- Add email notification to operator admins when operator list sync run encounters error [docs](/api/operator-lists#retrieve-the-sync-runs-of-a-filter-list)

## 2026-10-06

### 🚀 Features
- Email operator admins when a data-sharing run encounters an error

## 2026-10-06

### 🚀 Features
- Allow creating user link by phone without email [docs](/api/users#create-a-user)
### 🔧 Fixes
- Send phone, name and language as identity traits on user creation [docs](/api/users#create-a-user)

## 2026-10-06

### 🚀 Features
- Expose node external power limit on site detail [docs](/api/sites#retrieve-a-single-charge-site)
- Allow create user link by phone without email [docs](/api/vehicles#create-a-vehicle-authorization-link)
### 🔧 Fixes
- Send phone, name and language as identity traits on user creation [docs](/api/users#create-a-user)

## 2026-10-05

### 🚀 Features
- Add `motorcycleCompatible` and `hdvParkingSpot` fields to charge point PATCH [docs](/api/charge-points#patch-an-existing-charge-point)
- Add profile fields support on user creation [docs](/api/users#create-a-user)

## 2026-10-01

### 🚀 Features
- Add `teamCategory` field to team create and patch endpoints [docs](/api/teams#create-a-team)

## 2026-09-29

### 🚀 Features
- Add `driver_support_visibility` field to sites [docs](/api/sites#retrieve-a-single-charge-site)

## 2026-09-28

### 🚀 Features
- Add `meterId` field to charge point creation [docs](/api/charge-points#create-a-charge-point)
- Expose e-reports endpoint to partners [docs](/api/e-invoices#retrieves-the-e-invoices-issued-from-a-wallet)

## 2026-09-25

### 🚀 Features
- Add webhook entry replay functionality [docs](/api/webhooks#retrieve-webhook-entries)

## 2026-09-25

### 🚀 Features
- Add wallet e-report client and e-reports scope
- Expose charge key usage limits on update endpoints
### 🔧 Fixes
- Retry failed webhooks across most of a day and stop dead endpoints stalling the worker

## 2026-09-25

### 🚀 Features
- Add daily call counts per credential
- Serve the requestable scope catalog from one source
- Expose promotion code redeem deeplinks [docs](/api/deeplinks)
- Pin a team to an account template
- Gate e-invoice reads on `e-invoices:read` permission [docs](/api/e-invoices#retrieves-the-e-invoices-issued-from-a-wallet)
- Assign cost centers to teams, members, member profiles and charge keys [docs](/api/cost-centers)
- E-invoice module — list, detail and document [docs](/api/e-invoices#retrieves-the-e-invoices-issued-from-a-wallet)
- Add cost center create, update and delete endpoints [docs](/api/cost-centers)
- Expose cost centers via read endpoints (list + get) [docs](/api/cost-centers#retrieve-a-list-of-cost-centers)

## 2026-09-24

### 🚀 Features
- Add promotion code redeem deeplinks [docs](/api/deeplinks)
### 📦 Other
- Document green-energy claim rule on site energy mix [docs](/api/sites#retrieve-the-energy-mix-of-a-charge-site)

## 2026-09-18

### 🚀 Features
- Add durable install webhooks with retries and replay
- Enable webhooks on marketplace-minted consumers
- Add revenue-share settlement read endpoint [docs](/api/split-billing#retrieve-a-single-split-billing-settlement)
- Expose covered kWh per breakdown period on charge breakdown [docs](/api/charges#retrieve-a-charge-price-and-cost-breakdown)
- Expose per-charge fastpris coverage on charges [docs](/api/charges#retrieve-a-single-charge)
- Add charge cost savings value [docs](/api/charges#retrieve-a-single-charge)
- Implement team bank account management endpoints [docs](/api/team-bank-accounts#list-a-teams-bank-accounts)
- Add activate action endpoint for revenue-share policies [docs](/api/revenue-share#activate-a-revenue-share-policy)
- Add revenue-share agreement read endpoints [docs](/api/revenue-share#retrieve-a-single-revenue-share-agreement)
- Accept e-invoicing routing identifier on FR tax compliance [docs](/api/tax-compliance#register-an-operators-fr-tax-compliance)
- Add impact report on partner API [docs](/api/reports#retrieve-a-report-related-to-a-charge-point)
- Add support for printed identifier field for card inventory [docs](/api/charge-auth-tokens)
### 🔧 Fixes
- Describe webhook scopes accurately and group them [docs](/reference/ref-webhooks)

## 2026-09-10

🚀 *Features*
- Expose promotion code home-charging opt-in [docs](/api/promotion-codes#retrieve-a-list-of-promotion-codes)
- Expose charge odometer readings [docs](/api/charges#retrieve-every-odometer-reading-recorded-for-a-charge)
- Expose charge verification results [docs](/api/charges#retrieve-the-verification-outcome-and-detector-results-for-a-charge)
- Expose eMSP auth id on `Charge.protocolData` [docs](/api/charges#retrieve-a-single-charge)
- Create credit promotion codes in bulk from partner-supplied codes [docs](/api/promotion-codes#issue-many-single-use-credit-promotion-codes)
- Add revenue-share calculation read endpoint [docs](/api/revenue-share#list-revenue-share-calculations)
- Expose `deletedAt` and `includeDeleted` on revenue-share policy [docs](/api/revenue-share#list-revenue-share-policies)
- Add `inventoryOnlyChargeKeys` toggle for team and team settings [docs](/api/teams#retrieve-a-teams-settings)
- Make `averageCo2PerKwh` nullable [docs](/api/sites#retrieve-the-energy-mix-of-a-charge-site)
- Support dynamic (FILTER) operator lists [docs](/api/operator-lists#retrieve-a-list-of-operator-lists)
- Add revenue-share policy write endpoints [docs](/api/revenue-share#create-a-revenue-share-policy)
- Add revenue-share policy read endpoints [docs](/api/revenue-share#list-revenue-share-policies)

🔧 *Fixes*
- Return 400 instead of 500 for malformed request bodies
- Forward `teamId` when setting a price group as default [docs](/api/price-groups#sets-a-price-group-as-default)

## 2026-08-20

### 🚀 Features
- Added support for the per-user plan price model

## 2026-08-20

### 🚀 Features
- Add `selected_list_ids` passthrough for promotion codes [docs](/api/promotion-codes#create-a-promotion-code)
- Allow optional `teamId` on price group apply [docs](/api/price-groups#apply-price-group-to-charge-points-sites-or-team-members)
- Added support for the per-user plan price model

## 2026-08-14

### 🔧 Fixes

- Document that site charge points are returned as their site on the map [docs](/api/charge-points#retrieve-charge-points-sites-for-map)
- Clarify zoom behaviour on the charge point map [docs](/api/charge-points#retrieve-charge-points-sites-for-map)

### 📦 Other

- Drop boundingBox and includePublic from the v1 charge points spec [docs](/api/charge-points#retrieve-a-list-of-charge-points)

## 2026-08-12

### 🚀 Features
- Expose promotion code kWh allowance [docs](/api/promotion-codes#retrieve-a-list-of-promotion-codes)
- Expose `sendNotifications` on subscription create and bulk-create [docs](/api/subscriptions#create-subscription)
- Expose Operator Lists CRUD [docs](/api/operator-lists)
### 🔧 Fixes
- Return 502 instead of 200 when upstream response body cannot be decoded
- Require fiscal registration on tax compliance [docs](/api/tax-compliance)
- Fix promotion-code schema and status [docs](/api/promotion-codes#retrieve-a-list-of-promotion-codes)
- Declare `compliance_identifiers` values as strings [docs](/api/tax-compliance)
### 📦 Other
- Drop feature flag gate from feature-groups endpoints [docs](/api/feature-groups#retrieve-a-list-of-feature-groups)
- Simplify `recipientUserId` to `userId` in Messages contract [docs](/api/messages#list-messages-you-have-sent)

## 2026-08-06

### 🚀 Features
- Add `messages` and `charge-key-inventory` scopes to requestable permissions [docs](/reference/permission-scopes)

## 2026-08-06

### 🚀 Features
- Allow apps to request `messages` and `charge-key-inventory` scopes [docs](/api/authentication)
- Expose read-only rate-limit usage on the consumer endpoint [docs](/api/authentication#obtain-information-about-current-api-consumer)
- Declare how a data-sharing app connects via `connect_via`
### 🔧 Fixes
- Expose paying team, id tag, and all terminal types [docs](/api/payment-terminals#retrieve-a-single-payment-terminal)
- Fix authenticated partner-tier requests returning 500 errors
- Grant `offline_access` scope so partners receive refresh tokens [docs](/api/authentication#obtain-your-accesstoken)
- Send service token to prevent partner email 401 errors
- Prevent self-service signup from choosing its own distribution
- Pin OTel extension to JDK 21 build
- Bump OTel javaagent to 2.30.0 and lz4-java to 1.11.1 for CVEs

## 2026-08-06

### 🚀 Features
- Add public marketplace catalog for partners and apps
- Add partner admin review, OAuth consent, install reauth, and webhook rotation
- Register per-app OAuth client in Hydra
- Add Hydra consent handler and install mint
- Add GET partner install config endpoint
- Add partner org registration, review workflow, and App.Status state machine
- Add per-install webhook signing secret and `X-Monta-Install-Id` header
- Filter to show only manual consumers on the API keys page
- Add structured 403 `needs_reauth` response with `reauth_install_id` on scope expansion
### 🔧 Fixes
- Fix `partnerCustomPayload` schema documentation as object instead of array
- Fix auth header forwarding on background charge-point-identities call

## 2026-08-06

### 🔧 Fixes
- Fix `partnerCustomPayload` documentation to reflect object type instead of array [docs](/api/charges)

## 2026-07-31

### 🚀 Features
- Expose audit-log `TRIGGER` action, operation and source [docs](/api/audit-log#retrieve-single-audit-event-by-id)

## 2026-07-28

### 🚀 Features
- Expose `protocolError` fields on charge point OCPP responses [docs](/api/charge-points#retrieve-a-single-charge-point)

## 2026-07-13

### 🚀 Features
- Expose `maxChargeUsesCount` on promotion code endpoints

## 2026-07-13

### 🚀 Features
- Expose `maxChargeUsesCount` on promotion code endpoints

## 2026-07-01

### 🚀 Features
- Expose and accept `canManageChargeKeys` on team members and profiles
- Add `direction` parameter to CDR export

## 2026-06-29

### 🚀 Features
- Add `fromUpdatedAt` filter to GET `/users` endpoint

## 2026-06-25

### 🚀 Features
- Add team charge points endpoints: bulk update, reboot, search, and lock-cable
- Add subscription stats endpoints, subscribe via plan, and renew
- Add update local payment terminal endpoint
- Add `description` field to `AuthResourceScope` enum

## 2026-06-24

### 🚀 Features
- Add dynamic price management endpoints for `DYNAMIC` tariffs: list, upsert, and delete operations
- Expose `emspIdentifier` and `selfManaged` filters on CDR export endpoint

## 2026-06-24

### 🔧 Fixes
- Handle `null` `priceGroup` gracefully for team invites

## 2026-06-24

### 🚀 Features
- Add update members endpoint to team member profiles
- Expose resolve action on report endpoint
- Add `GET /api/v1/dashboard-statistics/network-overview` endpoint

## 2026-06-16

### 🚀 Features
- Forward site images
- Forward cursor site search
- Forward site developer-details
- Expose subscription note field
- Forward site amenities
- Forward site energy-mix

## 2026-06-16

### 🚀 Features
- Forward site images in partner API responses

## 2026-06-16

### 🚀 Features
- Expose auto-redeem team and user IDs in response body

## 2026-06-16

🚀 *Features*
- Forward site opening-hours in responses
- Expose `max_discount_amount` on promotion code endpoints
- Add `consumer.source` flag
- Add Apps Marketplace tables migration

## 2026-06-16

### 🚀 Features
- Update team schedule endpoint

## 2026-06-11

### 🚀 Features
- Add `PATCH /teams/{teamId}/schedules/{scheduleId}` to update team schedule
- Add `DELETE /teams/{teamId}/schedules/{scheduleId}` to delete team schedule
- Add `POST /teams/{teamId}/schedules` to create team schedule
- Add endpoint to get vehicle model details
- Add `POST /teams/{teamId}/plan-subscriptions` to subscribe team to plan
- Add cursor-based team search endpoint
- Add endpoints to share a vehicle with users
- Add v2 charge-keys resource
- Add `GET /teams/{teamId}/settings` to get team settings
- Add endpoint to transfer vehicle ownership
- Add `POST /vehicle-authorization-links` to create vehicle authorization link

## 2026-06-09

### 🚀 Features
- Expose `autoStart` on charge point GET responses

## 2026-06-09

🚀 *Features*
- Pass through `first_item_at` and `last_item_at` timestamps for split billing settlements
- Update installer job charge point
- Expose `national_id` field for user

## 2026-06-03

### 🚀 Features
- Add archive endpoint for installer jobs
- Add approve endpoint for sponsored charge points
- Add mark installer job complete endpoint
- Add list installer job charge points endpoint

## 2026-06-03

### 🚀 Features
- Add endpoint to remove team member fees

## 2026-06-03

### 🚀 Features
- Add create, get, update, and remove team member fee endpoints
- Add apply team member fee endpoint
- Add reject sponsored charge point endpoint
- Expose reimbursement fields on `team-member`, `team-member-profile`, and `sponsored-charge-point` endpoints
- Publish home endpoints in v1 docs under Teams
### 🔧 Fixes
- Deliver non-charge-point webhook events when `teamIds` filter is set
### 📦 Other
- Rename charge-point grid endpoints to `/grid` and drop V2 labels
- Move home endpoints under `/api/v1/teams/{teamId}/home`
- Update grid endpoint Swagger labels to PowerBank wording
- Clarify `canPayWithTeamWallet` is for shop purchases, not charging

## 2026-05-29

🚀 *Features*
- Support team-based filtering for charge-point events in webhooks

## 2026-05-29

🚀 *Features*
*- Add* `GET /price-groups/{id}/member-fees` endpoint
- Add `applied-teams` endpoint to Price Groups
- Allow operator-scoped `POST /price-groups`
*- Add* `charge-points` endpoint to Price Groups

🔧 *Fixes*
- Return charge point address for partial values in read endpoints

## 2026-05-27

🚀 *Features*
- Add GET `/cdrs` cursor-paginated endpoint

## 2026-05-21

### 🚀 Features
- Add POST `/team-members/bulk` for bulk invitations
- Add endpoint to transfer team ownership
- Add POST `/subscriptions/bulk` endpoint
- Add PUT `/subscriptions/{id}` endpoint
- Add PATCH `/operators` endpoint
- Add GET/POST `/operators/third-party-integrations` endpoints
- Add plan stats endpoint
- Add GET `/subscriptions/{id}/cancel/preview` endpoint
- Add reject team-member join request endpoint
- Add cursor-paginated GET `/charge-auth-tokens/search` endpoint
- Expose `selectedTeamIds` on promotion-code endpoints
- Add GET `/operators/{id}/sub-operators` endpoint
- Add `SplitBilling` price caps to endpoints and DTOs

## 2026-05-20

🚀 *Features*
- Expose `vehicleId` on Charge Auth Token endpoints
- Add manual vehicle creation flow

## 2026-05-15

### 🚀 Features
- Add residential charging plan support
- Add `POWER_BANK_PAYOUT` visibility filter
### 📦 Other
- Clarify energy charge-history endpoints for energy management

## 2026-05-15

### 🚀 Features
- Clarify energy charge-history endpoints exist for energy management

## 2026-05-15

### 🚀 Features
- Add `GET /payment-terminals/{type}/{id}/sessions` endpoint
- Add endpoints for listing and retrieving Split Billing Settlements
- Add `POST /payment-terminals/local` endpoint
- Add charge-point state action endpoints
- Add charge-points bulk-import multipart endpoint
- Add Themes CRUD endpoints
- Add charge point publish-settings endpoints
- Add `DELETE /payment-terminals/{type}/{id}` endpoint
- Add `PUT /payment-terminals/{paymentTerminalId}/charge-points` endpoint
- Expose charge-point auto-start endpoints
### 📦 Other
- Add `immediateAccess` field, deprecate `autoAccept` field

## 2026-05-15

### 🚀 Features
- Add `GET /payment-terminals/{type}/{id}/sessions` endpoint to retrieve payment terminal sessions

## 2026-05-08

### 🔧 Fixes
- Accept `partner_custom_payload` on team, member, and charge-point PATCH endpoints

## 2026-05-08

### 🚀 Features
- Pass `immediate_access` through for team invitations
- Add `POST /charge-points/{id}/sync-charge-keys` endpoint
- Add `POST /charge-points/{id}/transfer/teams/{teamId}` endpoint
### 🔧 Fixes
- Accept `partner_custom_payload` on team, member, and charge-point `PATCH` requests

## 2026-05-05

### 🚀 Features
- Forward `set-user-default-team` to backend
- Add team-level grid subscribe/unsubscribe across services
### 🔧 Fixes
- Align `DestinationType` OpenAPI enum with lowercase wire format
- Map paused subscription state and lower pricegroup fee log level

## 2026-05-05

### 🚀 Features
- Sync partner-api energy with service-energy
- Add CDR export endpoint
### 🔧 Fixes
- Require complete address or coordinates on `CreateSite`

## 2026-04-28

### 🚀 Features
- Expose `show_on_map` on sites

## 2026-04-24

### 🚀 Features
- Add filter params to `GET /api/v1/nested-teams`
- Add `ids` filter to `GET /api/v1/teams`

## 2026-04-22

### 🚀 Features
- Expose validity period on subscription response
- Add team tariff CRUD endpoints
### 🔧 Fixes
- Reduce webhook retry backoff from 5-min to 1-min multiplier

## 2026-04-20

### 🔧 Fixes
- Expose `Invoice.displayNumber`
- Bump Netty BOM to 4.2.11 and kafka-clients to 3.9.2 for CVE fixes

## 2026-04-20

### 🚀 Features
- Expose read-only Schedule endpoints
- Add GET `/users/{id}/charge-points` endpoint
- Add `sendWelcomeEmail` option to create user endpoint

## 2026-04-17

### 🚀 Features
- Add GET `/users/{id}/charges` endpoint
- Add PATCH `/users/{userId}` endpoint for updating user fields

## 2026-04-14

### 🚀 Features
- Add optional `operatorId` parameter to Create Site endpoint
### 🔧 Fixes
- Fix OOM in webhook delivery by making sends sequential

## 2026-03-31

### 🚀 Features
- Add `userId` field to charge point GET responses [docs](/api/charge-points#retrieve-a-single-charge-point)

## 2026-03-30

### 🚀 Features
- Add `validate-code` endpoint to promotion code gateway [docs](/api/promotion-codes#validate-a-promotion-code)
- Add `chargePointTeamId` filter to subscriptions endpoint [docs](/api/subscriptions#retrieve-a-list-of-subscriptions)

## 2026-03-27

### 🚀 Features
- Add V2 grid endpoints; V1 endpoints now call V2 service internally [docs](/api/charge-points#get-powerbank-status)
- Ensure setup intent creation includes mid region publishable key

## 2026-03-25

### 🔧 Fixes
- Fix snake_case for `country_id` and `currency_id` fields
- Add missing `team` and `selected_operators` values to `TeamWalletChargePaymentType` [docs](/api/charges)

## 2026-03-23

### 🚀 Features
- Add create, update, and delete operations for vehicles [docs](/api/vehicles#create-a-vehicle)
- Add vehicle integration connect and unlink endpoints [docs](/api/vehicles#connect-a-vehicle-integration)
- Add `vehicle_brands`, `vehicle_models`, and `vehicle_connectors` endpoints [docs](/api/vehicles#retrieve-a-list-of-vehicle-brands)

## 2026-03-18

### 🔧 Fixes
- Accept empty string query params for enum filters

## 2026-03-11

### 🚀 Features

* Add PATCH endpoint for user contacts [docs](/api/users#update-contact-information-for-a-user)

## January 2026

### 🚀 Feature

* **Themes:** Add themes read only endpoints and introduce themeId support for team endpoints 
* **Transactions:** Add team id filter to get wallet transactions by invoice id  
* **Grid:** Add grid service configuration


## November 2025

### 🚀 Feature

* **Wallet Transactions:** Add new `referenceType` `POWER_BANK_PAYOUT` to wallet transactions.

### 🐛 Other

* **Webhooks:** Increased speed of delivery by 50%


## October 2025

### 🚀 Feature

* **Charge Point Statistics:** Add new field `exemptState` which exposes the exempt state set on a charger.

### 🐛 Fix

* **Error Handling:** Details are omitted when causing unexpected errors, such as invalid JSON bodies.

## September 2025

### 🚀 Feature

* **Charges:** Add new field `Charge.cost` which exposes the occurred charge costs if set up (via cost price group)
* **Webhooks:** We have improved the latency (from event creation until delivery) significantly:
  * avg latency: from 8000ms to \<2000ms
  * p90 latency: from 12000ms to \<3000ms
* **Price Groups:** You can configure spot-price pricings to support 15-min intervals instead of 60-min. While you can update this across all price group types, it is only officially supported for price groups of type `cost`, `reimbursement` and `sponsored`. **Note:** The underlying platform feature (15-min MTU for spot-prices) will be introduced End of September).
* **Organization authorization:** Added to the following domains:
  * Charge Auth Tokens
  * Plans
  * Price Groups
  * Subscriptions
  * Users

### 🐛 Fix

* **Teams:** When using org-auth, the provided `operatorId` on team creation endpoint works properly now.
* **Deeplinks:** Fixed a bug preventing to update an existing deeplink to a charge point resource.
* **Charge Points:** `GET /charge-points` is ordered by id, ascending now.

## August 2025

### ⚠️ Deprecations

* **Subscriptions:** The request body field `firstPurchaseAt` in approve-subscriptions endpoint has been deprecated. Use `nextPurchaseAt` instead (for consistency reasons).


### 🚀 Feature

* **Charges:** Add new field `Charge.kwhPerMaxResolution` which provides kWh consumption in highest available resolution (usually 15min buckets).
* **Subscriptions:** When creating a subscription you can provide `nextPurchaseAt` now.


### 🐛 Fix

* **Currencies:** Brought back the `id` field where it was missing.
* **Charges:** `Charge.kwhPerHour` provides kWh consumption in hourly buckets.
* **Subscriptions:** When filtering by multiple criteria in the list endpoint, only the first criteria was considered.
* **Users:** When retrieving users, `includeDeleted` filter works properly now
* **Users:** `createdAt`, `updatedAt` and `deletedAt` are taken from the respective Application User instead of the underlying user. This allows you to identify when a user signed up for / deleted the account from your app. This is necessary since the same user might belong to many applications (ie. Monta and your whitelabel application).

## July 2025

### 🚀 Feature

* Added `roaming` and `roamingPriceGroupId` to the patch endpoint of charge points. With these fields an operator can enable roaming for its charge points. 
* Added `paymentMethod` to the patch and post endpoints of team.
* Added `paymentMethod` to the response of team endpoints.
* Added `invoiceRequest` to the response of team endpoints.

## June 2025

### 🚀 Feature

* Added `fromUpdatedDate` filter to the charge-points endpoint, which filters charge-points that their `updatedAt` is greater than `fromUpdatedDate`
* Added `showOnMap` field to the response of charge point endpoints
* Added `invitedBy`, `acceptedBy`, `phone` and `email` fields to the response of team member endpoints.
* Added `meterId` field to charge-point PATCH request payload.
* Added `meterId` field to the response of charge-point endpoints.
* Added `protocolData` field to the response of charges endpoints.
* Added `metaData` to a charge-point and site to get further information about amenities and capabilities

## May 2025

### 🚀 Feature

* added `memberCostPriceGroupId` to the response of charges endpoints.
* Added `fromCompletedDate` filter to the charges endpoint, which filters charges that their `completedAt` is greater than `fromCompletedDate`
* Added `toCompletedDate` filter to the charges endpoint, which filters charges that their `completedAt` is less than `toCompletedDate`
* Added `fromUpdatedDate` filter to the charges endpoint, which filters charges that their `updatedAt` is greater than `fromUpdatedDate`
* Added endpoint to get wallet transactions to V2024-07-01 `/wallet-transactions`This endpoint has been streamlined for improved performance and have slimmed-down request/response structure.\
  .

## April 2025

### 🚀 Feature

* Added endpoint to get receipts by charge ID `/receipts/by-charge/{chargeId}`
* Added endpoints to enable charge point low level configuration
  * POST `/charge-points/{chargePointIdentity}/ocpp-config`
  * GET `/charge-points/{chargePointIdentity}/ocpp-config`
* Added a new [endpoint](/api/webhooks#endpoint-to-generate-and-explain-signature-details) to allow you verifying generation of signatures

## March 2025

### 🚀 Feature

* Added new endpoints to set and clear **charge profiles**:
  * POST `/charge-points/{chargePointIdentity}/set-charging-profile`
  * POST `/charge-points/{chargePointIdentity}/clear-charging-profile`
* Added `chargePointIdentity` to the response of **charge-point-integrations**
* Added `protocolData` field to the response of all the **charge-points** endpoints (i.e. `/charges-points/*`) except `/map` endpoint.
* Added new field `humanReadableId` for **Charges**
* Added new field `vid` for **Charges**. Can be used to create Auto Charge flows.
* **Teams** can be filtered by `updatedAt` date now -> `fromUpdatedAt`: includes all teams that were updated after (including) `fromUpdatedAt`

## February 2025

### 🚀 Feature

* Added endpoints for vehicles to get a vehicle by id, list vehicles and get vehicle integration.
  * **GET** `api/v1/vehicles/{vehicleId}`
  * **GET** `api/v1/vehicles`
  * **GET** `api/v1/vehicles/integration/{integrationId}`
* Added support for webhooks in organization authorization. If an API client has access to its sub-operator, it will also receive webhook events for that sub-operator.
* Added `emaidProviderId` field to the response of all the charge endpoints (i.e. `/charges/*`)
* Introduced a new endpoint, `v1/auditlog/events`, for accessing the audit log
* Added `vehicleId` field to the response of all the charge endpoints (i.e `/charges/*`)
* Added endpoints for reviewing sponsored charge point cost changes
  * **POST** `api/v1/sponsored-charge-points/approve-cost-changes`
  * **POST** `api/v1/sponsored-charge-points/reject-cost-changes`
* Added endpoints for managing **Charge Point Sensors** available endpoints are:
  * **POST** `api/v1/charge-point-sensors`
  * **PATCH** `api/v1/charge-point-sensors/{id}`
  * **GET** `api/v1/charge-point-sensors/{id}`
  * **GET** `api/v1/charge-point-sensors`
  * **DELETE** `api/v1/charge-point-sensors/{id}`

## January 2025

### 🚀 Feature

* Added `signedData` field to the response of all the charge endpoints (i.e. `/charges/*`)
* Added functionality to retrieve a breakdown of KWh consumption for a charge
* Included `siteId`to charge point statistics response
* Added a `chargePointOperatorId` field to the `publicChargePoint` object in the Charges response
* Resolved an issue with pagination on the `/webhooks/entries` endpoint

## December 2024

### 🚀 Feature

* Official support for creating **Subscriptions** for teams has been added.
* Added new filters `customerId` and `customerType` for list the **Subscriptions** endpoint.
* Added new endpoint `/charge-points/{chargePointId}/reboot` to reboot a **Charge Point**.
* Added new endpoint `/charge-points/{chargePointId}/unlock` to unlock a **Charge Point**

## October 2024

### 🚀 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](/docs/integration-notes#rate-limiting) 
* 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.
* Introduced the ability to assign an `operator_id` to a **Team** when not provided the default will be assigned.

### 📝 Docs

* We added a new Guide around [Charge States](/docs/charge-states)
* We added a new Guide around [Partner External Id](/docs/partner-external-id)

### 🐛 Fix

* Improved performance on wallet transaction endpoint

## September 2024

#### 🚀 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

## August 2024

#### 🚀 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

## July 2024

### 🚀 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

## June 2024

### 🚀 Feature

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

## May 2024

### 🚀 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.

## April 2024

### 🚀 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**

## March 2024

### 🚀 Feature

* Added `vatNumber` to **Teams** model

## February 2024

### 🚀 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}`

## January 2024

### 🚀 Feature

* Added field `startSource` on the **Charges** response, the full dictionary of types and descriptions can be found [here](/docs/start-sources)
* 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/forecast`is currently in BETA phase, changes and might be subject to change in a near future release

## November 2023

### 2023-11-23

#### 🚀 Feature

* New endpoint for **Charges** insights `/charges/insights`
  * This endpoint lets you get insights and breakdowns about charges for a specified period. You can get these insights:
    * totalKwh
    * totalPrice
    * totalCost
    * totalSessions
  * Broken down by charges performed at:
    * operator
    * external
    * sponsored
    * total
* New endpoint to `get` and `list` **Currencies**
* New endpoint to `get` and `list` **Operators**
* Added support to set the flag `canManageTeamMembers` for **Team Members** via **POST** and **PATCH**. 
* Updated documentation around **Charges** state
* Added new the **ChargePointAuthToken** partnerExternalId on the **Charges** response.
* **Team Members**: Added new filter to filter **Team Members** by their state.
* **Team Members**: Added new filters to filter **Team Members** by their `userI`, `phone` or `email`.
* **Team Members**: Added new endpoint to resend **Team Member** invitations.

#### 🐛 Fix

* The Resource `Not Found`The message was ambiguous in specific situations; this has been fixed now
* Add new price group type `reimbursement`
* Renamed `partnerId` in `charge.genericPaymentSession` to `partnerExternalId`
* Fix an issue with `sponsoredChargePointId` missing on some sponsored charges
* Fix an issue where empty tariffs were added to each charge breakdown item
* Renamed `occp` to `ocpp`, the protocol name was wrongly spelled.
* Fix **Charge Points** costPriceGroup was wrongly mapped and therefore always null
* Fix **Charge Auth Tokens** partnerExternalId and partnerCustomPayload were not being persisted during the creation step

> 🚧 Deprecation Note
>
> * We have deprecated `priceBreakdown ` and `costBreakdown` fields on the **Charge** model both fields **will be removed by 31.01.24**. As a replacement for those fields, please use `charges/:chargeId/breakdown`.

## September 2023

### 2023-09-29

#### 🚀 Feature

* When creating a **Subscription** you can set `discountPercentage` and `discountAbsolute`
* New endpoint for **Charges** at `/charges/:id/breakdown` to retrieve price and cost breakdown
* New endpoints to manage **Installer Jobs** - they can be created, deleted, and retrieved
* New **Webhook** entity added: **Team Members** - you can use this to get informed when a team member accepts their invite.
* You can use the **Webhook Config** endpoint to **limit webhooks to certain Event Types**, currently:
  * `charges`
  * `charge-points`
  * `sites`
  * `team-members`
  * or provide `*` to get all entity changes delivered to your webhook endpoint
* Added two new fields to **Wallet Transactions**:
  * `kind`: gives a hint about the reason for this transaction, ie. charge-sponsored, tax-refund, ...; Note that as of now we have 118 kinds and this list will grow over time. We will add more docs moving forward.
  * `vatPercentage`: the amount of VAT that was part of this transaction
* Allow filtering **Subscriptions** by `subscriptionPurchaseId`. This allows you to find a subscription related to a wallet transaction with `referenceType` `SUBSCRIPTION_PURCHASE` and its `referenceId`
* New endpoint to delete a **Tariff Period Group**
* New endpoint to delete a **Tariff Recurring Period**
* New endpoint to delete a **Site**
* New endpoint to delete a **Charge Point**
* Added `currency` as part of the **Teams** 
* **Team Members** have a new field \`canRequestSponsoring which you can read/write
* **Webhooks are enabled for all existing and new consumers**
* **Charges that you paid for** can be obtained by using the new `operatorRole` filter on `GET /charges` with value `payer`
* Added new fields to **Charge Point** model to determine its **Price Groups**
  * `priceGroupId` - id of the public price group
  * `roamingPriceGroupId` - id of the roaming price group
  * `costPriceGroupId` - id of the cost price group
  * `sponsoredPriceGroupId` - id of the sponsored price group
* Added new endpoints to retrieve your **Payment Terminals**
* Added new endpoints to retrieve your **Subscription Purchases**
* Added new endpoints to retrieve and setup **Charge Point Integrations**
* New **Webhook** entity added: **Wallet Transaction** - you can now get notified when a wallet transaction is created or updated.
* New **Webhook** entity added: **Subscription** - you can use this to get informed when this entity is created or updated.
* New **Webhook** entity added: **Plan** - you can use this to get informed when this entity is created or updated.
* New **Webhook** entity added: **Installer Job** - you can use this to get informed when this entity is created or updated.
* New **Webhook** entity added: **Price Group** - you can use this to get informed when this entity is created or updated.
* New **Webhook** entity added: **Team** - you can use this to get informed when this entity is created or updated.
* New **Webhook** entity added: **Team** - you can use this to get informed when this entity is created or updated.
* Add new metadata section for **Wallet Transactions** metadata section will used to enrich transactions with either **Charge** or **Tax Refund** data.
* Added **granular scopes**: you can now specify not only the entities accessible by a consumer but also if they can read, write, or delete ([read more](/reference/ref-authentication#scopes))
* From now onwards, it is possible to patch the **Team** owner via Api
* Exposing the  `chargePointKw` for the **Charges** response.
* `chargePointIds` are not mandatory anymore for patching a **Team Members**
* Exposing the  `serialNumber` for **Sponsored Charge Points**  responses.

#### 🐛 Fix

* Fixed `connectorId` is not mandatory to create  **Charge Point Integrations** anymore.
* Add a new flag called `autoConnect`to allow setting up **Charge Point Integrations** without having to point the **Charge Point** to Monta
* Fixed issue when setting up **Charge Point Integrations** the `connectorId` was being set to `0` instead of `1` when not provided.
* Sorting **Charge Points** and **Sites** by location now allows negative latitude and longitude.

### 2023-09-19

#### 🚀 Feature

* When creating a **Subscription** of type `tax-refund` you can modify `payoutPerKwh` and `priceIncludesVAT` field.

#### 🐛 Fix

* Update **Plans** and **Subscription** models
* Fixed `fromDate`/`toDate` filter for **Wallet Transactions**
* Add `endDayOfWeek` to **Tariff Recurring Period**

### 2023-09-14

> 🚧 Deprecation Note
>
> * We have deprecated `operatorId` field on Team models. Use the new field `operator` instead. **The old field will be removed by 01.12.23**.
> * We have deprecated `maxKW` field on various model. Use the new field `maxKw` instead. **The old field will be removed by 01.12.23**.

#### 🚀 Feature

* Introduced endpoints for listing and retrieving `Sponsored Charge Points`
* Added endpoints for listing and retrieving `Plans`
* Implemented endpoints for creating, updating, canceling, and fetching `Subscriptions`
* Added support for specifying multiple days for  `Tariffs Recurring Periods`
* `Charge Auth Tokens` Added support for the following fields when creating or updating:
  * `userId`
  * `teamId`
  * `montaNetwork`
  * `roamingNetwork`
  * `activelUntil`
* `Price Groups`
  * New endpoint to set a default price group
  * New endpoint to apply a price group to Team Members, Charge Points, and Sites
  * Added the ability to specify a `from/to` dates for a fee
  * Price groups now support multiple tariffs
* `Webhooks`
  * Expanded webhook support for Charge Points and Sites
  * Charges events will also be triggered when the charge was paid by the operator

#### 🐛 Bugs

* Fixed display name missing for team members on the charges endpoint

#### 📝 Docs

* Updated and added API documentation for `Price Groups`, `Subscriptions`, `Sponsored Charge Points`, and more

## August 2023

### 2023-08-31

#### 🚀 Feature

* Create a `Team` no longer requires *userId*  to be provided
* Create/Update `Tariffs` no longer requires *countryAreaId* to be provided
* Added the *user* and *team member* (if from CP's team) associated with a `Charge`
* `Charge Auth Tokens` usage can now be limited to the operator's network.
* Added support for *partnerExternalId* and *partnerCustomPayload* for `Wallet Transactions`
* Added patch endpoint for `Wallet Transactions`
* Added new filters to GET `/wallet-transactions`, you can now filter by:
  * `referenceType`
  * `referenceId`
  * `state`
  * `group`
  * `partnerExternalId`
* Added new field `activeAt` to Charge Point model, indicating when the Charge Point was (last) activated

#### 🐛 Fix

* Price Groups: Added type `roaming`
* Tariffs:
  * Fixed an issue where GET resource by ID would return 401
  * Fixed an issue with the validation of non-overlapping recurring periods with the same weekday
  * Fixed an issue with `PATCH /tariffs/:id`That would lead to `BAD_REQUEST`

#### 📝 Docs

* Added/Updates API documentation for `Wallet Transactions`, `Price Groups`, `Subscriptions`,  and others.

### 2023-08-16

#### 🚀 Feature

* **Beta** / For selected partners: We are launching our webhooks system, starting with charge transactions. Check out the [guide](/docs/webhooks) and the [api docs](/reference/ref-webhooks). 🚀
* Added support to starting a `Charge` with `kWhLimit` or `socLimit`
* Added new endpoints to list and fetch `Country Area`
* Added `displayName` and `priceGroupId` for the `Team Member` model.
* Expanded patch `Team Member` to support more fields
* Added new filter by the state  for `Charge Points`
* Operators can now access the `Charges` paid by their teams via `GET /charges/:id` endpoint. However, they are not yet included in the `GET /charges` endpoint. This will come in a later release.
* Added new field type for `Charges` 

#### 🐛 Fix

* Fixed access checks when fetching `Wallet Transactions` by id were causing `403`
* Fixed access checks when fetching `Price Groups` by id were causing `403`

#### 📝 Docs

* Added/Updates API documentation for `Team Members`, `Price Groups`, and others.
* Split our API docs in [guides](/docs) and [api reference](/reference)

### 2023-08-03

#### 🚀 Feature

* Added new endpoints to list, create, update, and delete `Price Groups`
* Added endpoint to create (invite) and delete a `Team Member`
* Added endpoint to delete a `Team`
* Allow listing deleted `Sites` and `Charge Points`
* Partners can now use Monta's receipt system when providing `genericPaymentSession` when starting a `Charge`
* New Endpoints to fetch, list, create and update the following entities in the tariffs context: 
  * `Tariffs`
  * `Period Groups`
  * `Recurring Periods`
* Added endpoint to generate the `Prices` for a given tariff

#### ⚠️ Breaking change

* Previously, the `userId` field for `Team Member` was a non-nullable field, from this version onwards this field is nullable.

#### 📝 Docs

* Added/Updates API documentation for `Price Groups`, `Team Members`, and `Tariffs`
* Added detailed documentation for Price Groups.

## July 2023

### 2023-07-20

#### 🚀 Feature

* Beta `Price Groups` endpoints are officially retired. The new price groups endpoints will be available soon
* `Wallet Transactions` can now be fetched by `teamId`
* Added the `referenceId` field for `Wallet Transactions`
* Added support for filtering resources with null `partnerExternalId`
* Added new `/api/v1/consumers/me`, `api/v1/auth/me` is now deprecated, please migrate to the new one
* Exposing operator data for:\
  &#x9;	\- `Teams`\
  &#x9;	\- `Charges`\
  &#x9;	\- `Charge Points`,\
  &#x9;	\- `Charge Auth Tokens`,\
  &#x9;	\- `Sites`

#### 🐛 Fix

* Fixed typo for `team-has-fund` payments method

#### 📝 Docs

* Removed beta `Price Groups` docs
* Added documentation for new `Consumer` endpoint
* Updated documentation for existing endpoints, query parameters, and fields

### 2023-07-06

#### 🚀 Feature

* Added a Patch `Team Member` endpoint. Setting charge point ids for a `Team Member` is now supported
* Ability to sort `Charge Points` by location via the `sortByLocation` query parameter
* Updated `Charge Point Model` to expose the models supported features
* Updated `Charge Point` model to expose the `evse_id`

#### 📝 Docs

* Updated documentation for new endpoints, query parameters, and fields

## June 2023

### 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`

## May 2023

### 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.

## March 2023

### 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

## February 2023

### 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

## January 2023

### 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

## December 2022

### 2022-12-14

#### 🚀 Feature

* Filter Charges, Sites and Charge Points by `teamId`
* Wallet Transactions now have the `createdAt` and `updatedAt` fields
* New fields `kwhPerHour`and `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

## November 2022

### 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.

## September 2022

### 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)

## July 2022

### 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.

## June 2022

### 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

## Initial Release

### 2022-05-31

#### 🚀 Feature

* Initial Release with Sites, Charge Points, Charges, Wallet Transactions and Start/Stop charging