Monta

Changelog

2026-10-22

🚀 Features

  • Expose saved payment methods on teams and users docs
  • Expose customFields on teams docs
  • Move a meter to another node docs
  • Add site change-log count endpoint docs
  • Set team charge intents on sites docs
  • List vehicles across sites docs
  • Add paged search for energy sites docs
  • Clear an EVSE's charge intent docs
  • Set a node's power-limit schedule docs
  • Move an EVSE to another node docs
  • Set charge intents for site users docs

🔧 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

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
  • Align energy vehicle model with service-energy

2026-10-15

🚀 Features

  • Add financeCommunicationEmail field to team and operator endpoints docs
  • Add Shelly meter integration endpoints docs
  • Return meter-specific properties on site detail docs
  • Expose countrySubdivisionCode on sites, charge points, and teams docs
  • Rename charge-key inventory to charge auth token inventory and add includeDeleted filter docs
  • Accept autoRegisterRfid on charge point create and return in v2 docs

🔧 Fixes

  • Forward tariff recurring period minutes to grid-data docs
  • Document 403 response for deeplinks without an operator docs
  • Keep omitted site settings on partial update docs
  • Read vat_from_amount in v2 wallet transactions list docs
  • Declare response schema on POST create endpoints docs
  • Clarify when fullyChargedAt is set docs
  • Document node external power limit semantics docs

2026-10-15

  • Document when fullyChargedAt is set docs
  • Document 403 response for deeplinks without an operator docs

2026-10-06

🚀 Features

  • Add email notification to operator admins when operator list sync run encounters error docs

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

🔧 Fixes

  • Send phone, name and language as identity traits on user creation docs

2026-10-06

🚀 Features

  • Expose node external power limit on site detail docs
  • Allow create user link by phone without email docs

🔧 Fixes

  • Send phone, name and language as identity traits on user creation docs

2026-10-05

🚀 Features

  • Add motorcycleCompatible and hdvParkingSpot fields to charge point PATCH docs
  • Add profile fields support on user creation docs

2026-10-01

🚀 Features

  • Add teamCategory field to team create and patch endpoints docs

2026-09-29

🚀 Features

  • Add driver_support_visibility field to sites docs

2026-09-28

🚀 Features

  • Add meterId field to charge point creation docs
  • Expose e-reports endpoint to partners docs

2026-09-25

🚀 Features

  • Add webhook entry replay functionality docs

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
  • Pin a team to an account template
  • Gate e-invoice reads on e-invoices:read permission docs
  • Assign cost centers to teams, members, member profiles and charge keys docs
  • E-invoice module — list, detail and document docs
  • Add cost center create, update and delete endpoints docs
  • Expose cost centers via read endpoints (list + get) docs

2026-09-24

🚀 Features

  • Add promotion code redeem deeplinks docs

📦 Other

  • Document green-energy claim rule on site energy mix docs

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
  • Expose covered kWh per breakdown period on charge breakdown docs
  • Expose per-charge fastpris coverage on charges docs
  • Add charge cost savings value docs
  • Implement team bank account management endpoints docs
  • Add activate action endpoint for revenue-share policies docs
  • Add revenue-share agreement read endpoints docs
  • Accept e-invoicing routing identifier on FR tax compliance docs
  • Add impact report on partner API docs
  • Add support for printed identifier field for card inventory docs

🔧 Fixes

  • Describe webhook scopes accurately and group them docs

2026-09-10

🚀 Features

  • Expose promotion code home-charging opt-in docs
  • Expose charge odometer readings docs
  • Expose charge verification results docs
  • Expose eMSP auth id on Charge.protocolData docs
  • Create credit promotion codes in bulk from partner-supplied codes docs
  • Add revenue-share calculation read endpoint docs
  • Expose deletedAt and includeDeleted on revenue-share policy docs
  • Add inventoryOnlyChargeKeys toggle for team and team settings docs
  • Make averageCo2PerKwh nullable docs
  • Support dynamic (FILTER) operator lists docs
  • Add revenue-share policy write endpoints docs
  • Add revenue-share policy read endpoints docs

🔧 Fixes

  • Return 400 instead of 500 for malformed request bodies
  • Forward teamId when setting a price group as default docs

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
  • Allow optional teamId on price group apply docs
  • 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
  • Clarify zoom behaviour on the charge point map docs

📦 Other

  • Drop boundingBox and includePublic from the v1 charge points spec docs

2026-08-12

🚀 Features

  • Expose promotion code kWh allowance docs
  • Expose sendNotifications on subscription create and bulk-create docs
  • Expose Operator Lists CRUD docs

🔧 Fixes

  • Return 502 instead of 200 when upstream response body cannot be decoded
  • Require fiscal registration on tax compliance docs
  • Fix promotion-code schema and status docs
  • Declare compliance_identifiers values as strings docs

📦 Other

  • Drop feature flag gate from feature-groups endpoints docs
  • Simplify recipientUserId to userId in Messages contract docs

2026-08-06

🚀 Features

  • Add messages and charge-key-inventory scopes to requestable permissions docs

2026-08-06

🚀 Features

  • Allow apps to request messages and charge-key-inventory scopes docs
  • Expose read-only rate-limit usage on the consumer endpoint docs
  • Declare how a data-sharing app connects via connect_via

🔧 Fixes

  • Expose paying team, id tag, and all terminal types docs
  • Fix authenticated partner-tier requests returning 500 errors
  • Grant offline_access scope so partners receive refresh tokens docs
  • 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

2026-07-31

🚀 Features

  • Expose audit-log TRIGGER action, operation and source docs

2026-07-28

🚀 Features

  • Expose protocolError fields on charge point OCPP responses docs

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

2026-03-30

🚀 Features

  • Add validate-code endpoint to promotion code gateway docs
  • Add chargePointTeamId filter to subscriptions endpoint docs

2026-03-27

🚀 Features

  • Add V2 grid endpoints; V1 endpoints now call V2 service internally docs
  • 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

2026-03-23

🚀 Features

  • Add create, update, and delete operations for vehicles docs
  • Add vehicle integration connect and unlink endpoints docs
  • Add vehicle_brands, vehicle_models, and vehicle_connectors endpoints docs

2026-03-18

🔧 Fixes

  • Accept empty string query params for enum filters

2026-03-11

🚀 Features

  • Add PATCH endpoint for user contacts docs

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-transactionsThis 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 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 siteIdto 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
  • 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

🐛 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
  • 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

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 FoundThe 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)
  • 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 autoConnectto 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/:idThat 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 and the api docs. 🚀
  • 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 and api 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:
    - Teams
    - Charges
    - Charge Points,
    - Charge Auth Tokens,
    - 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 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

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
Last modified on