API Changelog

The changelog references the specific TandemDrive product versions where changes were introduced. You can find the current version on the About page of TandemDrive Console. Additionally, all API responses include an X-TD-Version header, which indicates the version of your TandemDrive instance. The API itself is also versioned, but it uses a single version number that rarely changes.

v3.55.0:
- Add some filter query parameters to the GET /cpo-charge-session{,-reimbursement} endpoints.
v3.53.1:
- Fix erroneous documentation for get /msp-roaming-command/{id}.
v3.53.0:
- In the responses of the GET /{end_user_id}/msp-charge-session/{chargesession_id} and the GET /{end_user_id}/msp-charge-session endpoints:
  - customer_total has been deprecated and replaced by the total_amount_excl_vat
  - and the total_amount_incl_vat as been added.
- The subtotals field in the response of GET /{end_user_id}/msp-charge-session now uses amount_excl_vat instead of the deprecated value and includes the new field vat_amount_unrounded.
v3.52.0:
- The POST /msp-token-subscription/{id}/token-fulfilment endpoint now only allows RFID form factors (which are card and keychain) and no longer allows unknown form factors.
- Add energy_credit and monetary_credit properties to the GET /{end_user_id}/msp-token-subscription/{subscription_id} response.
v3.51.0:
- Stabilize POST /charge-session endpoint and add the following fields: total_roaming_amount_incl_vat, total_roaming_flat_amount_excl_vat, total_roaming_energy_amount_excl_vat, total_roaming_time_amount_excl_vat, total_roaming_reservation_amount_excl_vat, session_id and connector_format.
v3.50.0:
- In the POST /charge-session endpoint: deprecate roaming_connection in favor of roaming_connection_id, deprecate total_cost_excl_vat in favor of total_roaming_amount_excl_vat and deprecate total_cost_incl_vat in favor of total_roaming_amount_incl_vat.
v3.47.0:
- Add connector_standard to GET /{end_user_id}/msp-charge-session/{chargesession_id} endpoint.
v3.46.0:
- Add GET /msp-charge-cost-calculation endpoint.
- Add the POST msp-token-fulfilment/activate-token endpoint.
- Added EVSE information to GET /cpo-charge-session-reimbursement (and webhook).
v3.45.1:
- Add POST /cpo-reimbursement-arrangement/{id}/switch-plan endpoint.
v3.43.0:
- Add seller_county to GET /administration response.
v3.41.2:
- Fix specification of billing rollup group by in GET /billing-box and GET /billing-box/{id}
v3.41.0:
- Add App API endpoints:
  - POST /{end_user_id}/msp-token-subscription/{subscription_id}/cancel
  - POST /{end_user_id}/msp-token-subscription/{subscription_id}/switch-plan.
- Add deactivated_at to EVSE location.
- Add optional new_plan_external_reference to POST /msp-token-subscription/{id}/plan-or-customer-correction request body.
v3.39.0:
- Fix specification of GET /billing-box-delivery-state to return list of billing_box_delivery.
- Add POST /msp-token-subscription/{id}/token-fulfilment endpoint.
v3.37.0:
- Promoted EVCO ID validation endpoint to “Stable”
  - The endpoint is no longer in “Preview”.
  - The response now includes a normalized ID for system integrations and a formatted ID for user display.
v3.36.0:
- Add billing_rollup_group_by to billing box export, and average_amount_per_kwh_excl_tax to rollup.
v3.35.0:
- Add POST /msp-token-subscription/{subscription_id}/plug-and-charge-vehicle endpoint.
- Add external_reference to billing_box_delivery.
v3.34.0:
- Remove reservation_id and expiry_date from the /msp-roaming-command and /msp-roaming-command/{id} endpoints, since they are only used for unsupported roaming commands.
- Add endpoints to manage billing box delivery state:
  - GET /billing-box-delivery-state
  - POST /billing-box-delivery-state
  - POST /billing-box-delivery-state/{id}
v3.33.0:
- Remove deprecated endpoints, which are currently not used:
  - PUT /main/v1/cpo-evse/{evse_uid}/reimbursement-mandatory
  - PUT /main/v1/cpo-evse/{evse_uid}
  - PUT /main/v1/cpo-evse-location/{location_id}
  - PUT /main/v1/cpo-subscription-plan/{id}/{valid_from}
v3.30.0:
- add the id and the context of the rollup item to the GET /billing-box/{id} endpoint.
v3.28.0:
- Add evse_uid and updated_at properties to the GET /cpo-dropout-case/{id} response.
- Add an optional reason query parameter to the GET /cpo-dropout-case endpoint.
- Add the updated_at property to the GET /cpo-dropout-case response.
- Remove the following properties from the GET /cpo-dropout-case response:
  - unknown_connector_id
  - unknown_evse_uid
  - unknown_location_id.
v3.27.0:
- Add endpoints to manage calculation inputs on a reimbursement plan:
  - GET /cpo-reimbursement-plan/{id}/calculation-input,
  - PUT /cpo-reimbursement-plan/{id}/calculation-input/{valid_from}/{component_type},
  - PUT /cpo-reimbursement-plan/{id}/calculation-input/{valid_from}/custom/{var_name},
  - DELETE /cpo-reimbursement-plan/{id}/calculation-input/{valid_from}/{component_type},
  - DELETE /cpo-reimbursement-plan/{id}/calculation-input/{valid_from}/custom/{var_name}.
- Changed the endpoint /msp-token-subscription/{id}/defunct so that also it’s token links are marked defunct.
- Changed the endpoint /cpo-reimbursement-arrangement/{id}/defunct so that also it’s EVSE/reimbursement links are marked defunct.
- Changed the endpoint /cpo-subscription/{id}/defunct so that also it’s EVSE/subscription links are marked defunct.
v3.26.0:
- Add a code field to the billing_series.
- Add the following fields to the response of the GET /billing-box/{id} endpoint:
  - billing_reviewset_code
  - billing_reviewset_id
  - billing_box_reviewset_sequence
  - billing_series_code
  - billing_series_external_reference
  - billing_series_id
- Add GET /billing-review-set endpoint.
- Add the POST /msp-token-subscription/add-virtual-token endpoint.
v3.21.0:
- Add addressee to billing address in various endpoints.
v3.20.0:
- Add the customer_external_reference field to the GET /cpo-charge-session-reimbursement and GET /cpo-charge-session-reimbursement/{id} endpoints.
- Deprecate all “Replace-Update” PUT-endpoints and some related endpoints which are no longer necessary. See the migration guide for more details.
- Add the party_external_reference query parameter to the GET /billing-box endpoint.
v3.18.0:
- Deprecate preferred_locale_ids of billing-box of GET /billing-box/{id} endpoint.
- Add locale_id to billing-box of GET /billing-box/{id} and GET /billing-box endpoints.
v3.17.0:
- Add new merge endpoints:
  - POST /end-user/{id}/authorization-customer/{customer_id}
  - POST /end-user/{id}/authorization-msp-token-subscription/{subscription_id}
  - POST /cpo-subscription-plan/{id}/{valid_from}
- Update POST /msp-token/{evco_id} to support merging.
- Add charge_periods to POST /cpo-charge-session.
v3.16.0:
- App API: Add a new billing box endpoint GET /{end_user_id}/customer/{customer_id}/billing-box.
- App API: Add a new billing document endpoint GET /{end_user_id}/billing-box/{id}/document/{filename}.
v3.15.0:
- Remove validation on billing_phone fields, increase max length to 40.
v3.12.0:
- Add two new merge endpoints
  - POST /cpo-evse/{evse_uid}
  - POST /cpo-evse-location/{location_id}
v3.11.0:
- Update the documentation of implicit fields. It should now be clearer how the API works with regard to optional fields.
v3.10.0:
v3.8.0:
- Add total_roaming_amount_excl_vat to cpo_chargesession and deprecate total_sales_amount_excl_vat, and adapt the POST /cpo-charge-session similarly.
v3.6.0:
- Add tariff_code to {GET, POST} /cpo-chargesession and GET /cpo-charge-session-reimbursement{/:id} endpoints.
v3.4.0:
- Move:
  - PUT /msp-token-subscription/{id}/plan-or-customer-correction
  - PUT /msp-token-subscription/{id}/energy-credit
  - PUT /msp-token-subscription/{id}/monetary-credit to:
  - POST /msp-token-subscription/{id}/plan-or-customer-correction
  - POST /msp-token-subscription/{id}/energy-credit
  - POST /msp-token-subscription/{id}/monetary-credit, for backwards compatibility the old versions remain functional.
v3.3.0:
- Extend the billing box filter of GET /billing-box and billing-box with reviewset_id.
v3.0.0:
- Add foreign currency totals to billing_box (#5494).
v2.79.0:
- Add the billing_series_external_reference field to GET /billing-box.
- Add the series_external_reference query filter to GET /billing-box.
- Add connector_id property to msp_roaming_command_start_session.
- Add mandatory time_zone to /biling-custom-item.
v2.78.0:
- Add the cdr_id and cpo_id to GET /billing-box/{id}/cpo-charge-session-reimbursement.
- Add the cpo_cdr_id and cpo_id to GET /billing-box/{id}/msp-charge-session.
- Added a list of roaming_agreements for each roaming partner to the GET /roaming-partner endpoint.
v2.76.0:
- Volumes in GET /billing-box/{id} are now maps with units as their keys.
v2.75.0:
- Added several new update endpoints to the admin API that allow updating only the specified fields. This makes them more versatile for partial updates and, in many cases, a better alternative to the corresponding PUT endpoints.
  - POST /billing-address/{id}
  - POST /billing-direct-debit-mandate/{id}
  - POST /customer/{id}
  - POST /msp-token-link/{id}
  - POST /msp-token-subscription/{id}
  - POST /cpo-reimbursement-arrangement/{id}
  - POST /cpo-reimbursement-link/{id}
  - POST /cpo-subscription/{id}
  - POST /cpo-subscription-evse-link/{id}
  - POST /end-user/{id}
- Various changes to the GET /billing-box and GET /billing-box/{id} endpoints.
v2.74.0:
- Change GET /msp-charge-session-priced and GET /cpo-charge-session-reimbursement from optional fields to nullable.
v2.73.0:
- Add explicit billing box state which also contains ready to billing_box schema.
- Add deferred to billing_box schema.
- Adapt the GET /billing-box endpoint to the explicit billing box state and the new ready state.
- Add the GET /billing-box/{id} endpoint, which retrieves a box and its details.
v2.72.0:
- Rename the GET /billing-box/{id}/cpo-charge-session endpoint to /billing-box/{id}/cpo-charge-session-reimbursement.
- Add the GET /cpo-charge-session-reimbursement/{id} endpoint.
- Add vat_country, vat_kind, vat_percentage to the cpo_chargesession_reimbursement.
- Add the rate_label, rate_unit and rate_represent_as_percentage fields to the following endpoints:
  - GET /msp-charge-session-priced
  - GET /msp-charge-session-priced/{id}
  - GET /{end_user_id}/msp-charge-session/{chargesession_id}.
- Add username property to enduser.
- Add mark_transferred query parameter to /billing-box/{id}/finalize which if set to true marks the box as transferred if not already done.
v2.70.0:
- Rename the GET /billing-box/{id}/cpo-charge-session-export endpoint to /billing-box/{id}/cpo-charge-session, and add vat_country field. The vat_country field has been added to this endpoint and in the subtotals field, the label and unit have been removed, and the vat_kind field has been added.
- Rename the GET /billing-box/{id}/msp-charge-session-export endpoint to /billing-box/{id}/msp-charge-session.
- Add the GET /billing-box/{id}/cpo-charge-session-roaming endpoint.
- Improve the documentation about eMobility identifiers, and EVSE ID and EVCO ID specifically. In practice we already accepted identifiers without separators, which is now better documented. In a future release we want to follow the recommendation by IDACS to not use separators in machine-to-machine communication.
- Rename document_type property of billing_series to primary_document_type.
- Add explicit billing box state which also contains ready.
- Adapt the GET /billing-box endpoint to the explicit billing box state.
v2.69.0:
- /billing-box/{id}/finalize will not mark the box transferred if not already done. /billing-box/{id}/transferred has to be explicitly called.
- Add the GET /billing-box endpoint.
- Rename the GET /billing-box/:id/msp-charge-session-export endpoint to /billing-box/:id/msp-charge-session. In the subtotals field of the endpoint, vat_rate_country_code is renamed to vat_country, vat_rate_kind to vat_kind and vat_rate_percent to vat_percent. The label and unit fields of the subtotals are removed.
v2.66.0:
- Remove details query parameter from, GET /msp-charge-session-priced/{id}, GET /msp-charge-session-priced/, endpoints.
- Add the GET /billing-product-category endpoint.
v2.64.0:
- Add the GET /billing-box/{id}/document endpoint.
- Remove connection_pub_id from evse_group.
v2.63.0
- Add vat_country to billing_box_msp_chargesession.yaml and vat_country on it’s subtotal is deprecated.
- Add vat_country to msp_chargesession_priced.yaml and vat_country on it’s subtotal is deprecated.
- Add vat_country to msp-charge-session.yaml and vat_country on it’s subtotal is deprecated.
v2.61.0
- Add rollup_group_by to billing-box.
- Deprecate rollup_method of billing-box.
- Add billing_rollup_group_by to customer.
- Deprecate billing_rollup_method of customer.
- Add plan to rollup_group_by.
v2.57.0
- Add period_from, period_until, volume and item_count to rollup line of billing-box.
v2.56.0
- Deprecate the received_at field on POST /cpo-charge-session.
- Add the unit and label properties to billing_item_cpo_chargesession.
- Add the unit, var_name and label properties to billing_box_msp_chargesession.
- Add billing document upload to billing-box finalize endpoint.
- Add a defunct property to billing_direct_debit_mandate.
- Add the PUT /billing-direct-debit-mandate/{id}/defunct endpoint.
- Certain identifier fields which were previously uppercased by TD, will be returned in their original casing. This change will happen in the next several API releases. Uppercasing these fields was an oversight from our side, since some parties expect us to return the original, unaltered value. These identifiers are still treated as being case insensitive (uniqueness and equality).
v2.52.0
- Add total_idle_seconds and remark properties to msp_chargesession.
- Add evse_id to /msp-charge-session-progress response.
v2.50.0
- Add new optional property brand_code to msp_token and PUT /msp-token/{evco_id} and POST /msp-token/{evco_id} request bodies.
- Add code property to GET /msp-token-brand response.
- Make EVSE uid optional for /msp-roaming-command/start-session.
- Add session status, total_energy_kwh, and last_update to /msp-charge-session-progress response.
- Add X-TD-Unknown-Fields header.
v2.48.0
- Add the cpo_id, cpo_cdr_id and roaming_connection properties to msp_chargesession_original.
- Add latitude and longitude to cpo_evse_location, add these fields as optional parameters to PUT /cpo-evse-location/{id} and POST /cpo-evse-location.
- Add the publish_from and publish_until properties to the following endpoints:
  - GET /cpo-subscription-plan
  - GET /cpo-subscription-plan/{id}
  - GET /cpo-reimbursement-plan
  - GET /cpo-reimbursement-plan/{id}
  - GET /msp-token-subscription-plan
- Deprecate the valid_from and valid_until properties of the GET /cpo-reimbursement-plan and GET /cpo-subscription-plan/{id} endpoints.
v2.47.0
- Add an optional used query parameter to the GET /msp-token endpoint.
- Remove id property from msp_token, since it could not be used anywhere.
- Add optional token_series_id and token_uid_type_id to POST /msp-token-subscription to also create a token when creating a subscription.
- Add the arrangement_external_reference property to cpo_chargesession_reimbursement, deprecating arrangement_reference.
- Deprecate the POST /cpo-evse endpoint.
- Deprecate the POST /cpo-evse-location endpoint.
- Add the plan_external_reference property to cpo_subscription.
- Add an optional body containing an external_updated_at property to the following endpoints:
  - DELETE cpo-reimbursement-arrangement/{id}/valid-until
  - PUT cpo-reimbursement-arrangement/{id}/defunct
  - DELETE cpo-reimbursement-link/{id}/valid-from
  - DELETE cpo-reimbursement-link/{id}/valid-until
  - PUT cpo-reimbursement-link/{id}/defunct
  - DELETE cpo-subscription/{id}/valid-until
  - PUT cpo-subscription/{id}/defunct
  - DELETE cpo-subscription-evse-link/{id}/valid-from
  - DELETE cpo-subscription-evse-link/{id}/valid-until
  - PUT cpo-subscription-evse-link/{id}/defunct
  - DELETE msp-token-link/{id}/valid-from
  - DELETE msp-token-link/{id}/valid-until
  - PUT msp-token-link/{id}/defunct
  - DELETE msp-token-subscription/{id}/valid-until
  - PUT msp-token-subscription/{id}/defunct
- Add an optional field external_updated_at to the request body of the following endpoints:
  - PUT cpo-reimbursement-arrangement/{id}/valid-from
  - PUT cpo-reimbursement-arrangement/{id}/valid-until
  - PUT cpo-reimbursement-link/{id}/valid-from
  - PUT cpo-reimbursement-link/{id}/valid-until
  - PUT cpo-subscription-evse-link/{id}/valid-from
  - PUT cpo-subscription-evse-link/{id}/valid-until
  - PUT cpo-subscription/{id}/valid-from
  - PUT cpo-subscription/{id}/valid-until
  - PUT msp-token-link/{id}/valid-from
  - PUT msp-token-link/{id}/valid-until
  - PUT msp-token-subscription/{id}/valid-from
  - PUT msp-token-subscription/{id}/valid-until
- Make the request body for the following endpoints optional:
  - PUT cpo-reimbursement-link/{id}/valid-until
  - PUT cpo-subscription-evse-link/{id}/valid-until
  - PUT cpo-subscription/{id}/valid-until
  - PUT msp-token-link/{id}/valid-until
  - PUT msp-token-subscription/{id}/valid-until
v2.45.0
- Add GET, PUT /end-user/{id}/authorization/customer endpoints.
- Add GET, PUT /end-user/{id}/authorization/msp-token-subscription endpoints.
- Add GET /end-user and POST /end-user/ endpoints.
- Add GET /end-user/{id}, PUT /end-user/{id} and GET /end-user-site endpoints.
- Add GET /end-user and POST /end-user endpoints.
- Add an optional form_factor property to msp_token, add GET /msp-token-form-factor endpoint.
- Add abbility to try API calls from within the documentation.
- Change **STATE: PREVIEW**, to a preview x-badge.
v2.42.0
- Add GET /msp-dropout-case, GET /msp-dropout-case/{id}, GET / cpo-dropout-case, GET /cpo-dropout-case/{id} endpoints.
v2.40.0
- Add GET /msp-roaming-command/{id}, GET /msp-charge-session-progress, make roaming commands explicit in the URL.
v2.39.0
- Add optional party_id parameter to POST /billing-custom-item.
- Add optional page_size parameter to routes support paging.
- Add links property when retrieving data from msp-token-subscription.
- Add GET and POST /msp-token-series endpoint.
- Add POST /msp-token-evco-id/validate endpoint.
v2.36.0:
- Rename revision to reversion in Category line of billing_box.
- Add optional box_category_description to billing_custom_item endpoint.
- Add GET /msp-roaming-command, POST /msp-roaming-command and GET /msp-roaming-command/{id} endpoints.
- Add PUT /cpo-evse/{evse_uid}/reimbursement-mandatory endpoint.
- Add PUT /cpo-evse/{evse_uid}/dropout-all-chargesessions endpoint.
- Add the admin_id property to billing_box, cpo_chargesession_reimbursement, msp_chargesession_priced, cpo_reimbursement_arrangement, cpo_subscription, msp_token_subscription.
- Prefer 400 for any client error instead of using other HTTP status codes.
v2.32.0:
- Add a demo-mode to the MSP EVSE-group endpoint. This allows one to get demo responses when no EVSE information is available, such as when testing.
v2.31.0:
- Add PUT /msp-token-subscription/{id}/plan-or-customer-correction endpoint.
v2.30.0:
- Add links property to both cpo_reimbursement_arrangement and cpo_subscription.
- Add DELETE /cpo-reimbursement-arrangement/{id}/calculation-input/{valid_from}/{component_type} and DELETE /cpo-reimbursement-arrangement/{id}/calculation-input/{valid_from}/custom/{var_name}, endpoints.
- Add bank_account_name, bic and iban properties to /direct-debit-mandate endpoints. See the specifications of the endpoint on how this works.
v2.29.0:
- Add PUT /cpo-reimbursement-arrangement/defunct.
- Add GET /billing-series, add ext_ref. support to GET /billing-series/{id}.
- Add GET /msp-charge-session-original and GET /msp-charge-session-original/{id}.
- Add POST /cpo-charge-session.
- Remove paging from GET /cpo-reimbursement-plan.
- Add links property when retrieving data from cpo_reimbursement_arrangement and cpo_subscription.
- Remove token_evco_id from POST /cpo-charge-session.
v2.27.0:
- Add vat_kind, vat_percent and vat_country to msp_chargesession_priced_subtotal.
- Add external_updated_at to /cpo-evse endpoints.
- Add upsert behavior to PUT /cpo-evse/{evse_uid}.
- Add connectors to PUT /cpo-evse/{evse_uid}, POST /cpo-evse, GET /cpo-evse, GET /cpo-evse/{evse_uid}.
- The status code 422 was sometimes used for validation errors while in many cases we used 400. From now on we only use status code 400 when we can’t parse or validate the incoming data.
v2.26.0:
- Add remimbursement_vat field to customers.
- Add buyer_reference to MSP token subscriptions, CPO reimbursement arrangements, and CPO subscriptions.
- Add administration_locale_id to GET /billing_box_transfer.
- Add locale_id to GET /administration.
- Add external_updated_at to /cpo-evse-location endpoints.
- Add upsert behavior to PUT /cpo-evse-location/{location_id}.
v2.22.0
- Add GET /cpo-reimbursement-link.
- Add upsert behavior to PUT /cpo-reimbursement-link.
- Add PUT /cpo-subscription-evse-link, incl. upsert behavior.
- Add invalidate_overlapping_mandate property to POST and PUT billing-direct-debit-mandate.
- Add subscription_external_reference property to msp_chargesession_priced.
- Add chargesession_id to pricing results of MSP charge sessions.
v2.21.0
- Add PUT /msp-token-subscription/{id}.
- Add PUT /msp-token-link/{id}.
- Add upsert behavior to PUT /cpo-reimbursement-arrangement/{id}.
v2.13.0
- Replace POST /cpo-reimbursement-arrangement/{id}/calculation-input with PUT /cpo-reimbursement-arrangement/{id}/calculation-input/{valid_from}/{component_type} and PUT /cpo-reimbursement-arrangement/{id}/calculation-input/{valid_from}/custom/{var_name}.
- Remove DELETE /cpo-reimbursement-calculation-input/{id}, inputs can now be removed by explicitly setting a value to null using the new PUT endpoints.
- Change response GET /cpo-reimbursement-arrangement/{id}/calculation-input to return an array of calculation inputs.
v2.11.0
- Rename total_excl_vat to total_amount_excl_vat of cpo_chargesession_reimbursement
- Change cpo_id of cpo_evse_location to be optional
v2.8.0
- Add charging_periods to reimbursement.
v2.7.0 2023-08-25:
- Add GET /msp-token-subscription-plan endpoint.
- Add support for adjusting the page size (preview).
- Add support for determining the rate and tariff at an location (preview).
v2.6.0 2023-08-10:
- Add subtotal_incl_vat to rollup of billing box.
- Fix specification of latitude and longitude properties to be decimals.
v2.1.0 2023-07-10:
- Add support for using prefixed external references to the customer, billing-address and direct-debit-mandate endpoints.
- Extend a number of request and response bodies with an external_reference or .._external_reference property.
- Make valid_until an optional parameter for POST /billing-direct-debit-mandate.
- Add optional locale_id to customer.
- Add external_updated_at to direct_debit_mandate.
- Add GET direct-debit-mandate/{id}.
- Add PUT direct-debit-mandate, including upsert behavior.
- Add upsert support to PUT /billing-address.
- Add external_updated_at to billing_address, and ignore updates older than last observed external_updated_at.
- Add external_updated_at to customer, and ignore updates older than last observed external_updated_at.
- Add GET billing_address/{id}.
v1.43.0 2023-06-14:
- Add customer_id, currency_code to msp-priced-charge-session.
- Add currency_code to cpo-charge-session-reimbursement.
- Add enduser/register endpoint
- Add id, customer_id, currency_code to msp-priced-charge-session.
- Add currency_code to cpo-charge-session-reimbursement.
- Add id to msp-charge-session.
- Add GET /msp-charge-session-priced/{id}.
- Add possibility to use id as after value for GET /msp-charge-session-priced and GET /msp-charge-session.
v1.39.0 2023-05-25:
- First end user endpoints (preview).
v1.37.0 2023-05-11
- Further improvement on billing endpoints (preview).
v1.36.0 2023-05-02
- CPO endpoints for EVSEs, reimbursements and charge sessions.
- Customer data has been extended with billing data (preview).
- Several billing endpoints (preview).
v1.34.0 2023-04-07
- Finalized CPO arrangement related endpoints.
v1.31.0 2023-02-21
- Add GET roaming-partner endpoint.
v1.28.1 2023-01-04
- Remove country as required from MSP charge sessions. This was a mistake in the previous API specifications.
v1.26.0 2022-12-06
- Add token_evco_id to msp-priced-charge-session, add rate to subtotal. Add is_currently_valid, and current_admin_id properties to msp-token. Add endpoints:
- GET customer/{id},
- GET msp-token/{evco_id}, containing a links property, next to the msp-token properties,
- GET msp-token-link/{id},
- GET msp-token-subscription/{id},
- PUT msp-token-link/{id}/defunct.
- Remove pagination from: GET administration, GET msp-token-uid-type, GET msp-token-brand, since the number of items returned from these endpoints will not reach the default page size. This is considered backward compatible because the paging URL parameters are optional. Do note that the page_size property has been removed from the response object, since it is no longer needed.
v1.24.0 2022-11-14
- Add initial_admin_id to msp-token.
v1.23.0 2022-10-18
- Change the valid_from field of an msp_token_link to be optional, deferring validity to the msp_token_subscription.
- Add: DELETE /msp-token-link/{id}/valid-from, DELETE /msp-token-link/{id}/valid-until, DELETE /msp-token-subscription/{id}/valid-until.
v1.21.0 2022-09-26
- Add GET version, GET /msp-charge-session/{id} endpoints add X-TD-Version header. Add optional details parameter to GET /msp-charge-session-priced. Change after parameter value to evco_id for GET /msp-token. Add ac_2phase_split to power_type.
v1.20.0 2022-09-14
- Rename the street property of msp-charge-session to address, this is perceived as a non breaking change since no production implementations are present at the moment.
v1.19.0 2022-09-05
- Add time_zone to msp-charge-session. Add received_at to msp-charge-session, fix several regular expressions and types in the schemas, fix parameter links for msp-token-uid-type and msp-token-brand.
v1.17.0 2022-08-18
- Add endpoints for customers, MSP tokens, token subscriptions, token links, several setup related endpoints and alternate pagination.
v1.7.0 2021-12-14
- Endpoints to retrieve MSP-side charge sessions.

Keyboard shortcuts

TandemDrive API Guide

API Changelog