HomeGuidesAPI ReferenceChangelog
Terms of Use
Changelog
Terms of Use

Release Notes: Public API 2.117.0

over 1 year ago by Svetoslav Mitov
  1. IntroduceLocations v2.0 resource
    1. Properties:
      • id - readonly
        integer
      • name - required
        string
      • status - required
        enum
      • shortDescription - optional, translatable
        array or NULL
      • description - optional, translatable
        array or NULL
      • additionalDescription - optional, translatable
        array or NULL
      • locationImage - optional, readonly
      • images - optional, readonly
      • geoposition - required
        • latitude - required
          float
        • longitude - required
          float
      • address - required
        translatable
      • city - required
        string
      • region - optional
        string
      • state - optional, conditional depending on country = US or AU
        string or NULL
      • country - required
        string
      • postCode - required
        string
      • workingHours - required
        array
        • isAlwaysOpen - required
          boolean
        • alwaysOpenForUserGroupIds - optional
          array of group ids
          required if isAlwaysOpen = false; otherwise NULL
        • stopSessionsOutsideWorkingHours - optional
          boolean
          required if isAlwaysOpen = false
        • hours - optional
      • chargingZones - required, readonly
        array
      • timezone - optional (only when multi timezone is enabled)
        string
      • externalId - optional
        string
      • lastUpdatedAt - required
        timestamp
  2. ExposeCharging Zones endpoint in the API
    Supported Methods:GET, POST, PATCH,DELETE
    • Properties:
      • id
        integer
      • name - required
        string
        Description: Internal name of the Charging Zone. This isn't visible to end-users in the app.
        locationId - required
        integer
        Description: The ID of the Location, which the Charging Zone belongs to.
      • status - required
        string
        Description: Enum: "active" "disabled"
      • appAdditionalInfo - optional
        object
        Description: Additional information for the charging zone that is shown in the mobile app when the Location is viewed.
      • title - required
        object
        Description: Locales that have been created and are not provided on an update will be deleted. Please provide values in all locales that you wish to keep.
      • description - required
        object
        Description: Locales that have been created and are not provided on an update will be deleted. Please provide values in all locales that you wish to keep.
    • Filter
      • locationId

Release Notes: Public API 2.116.0

over 1 year ago by Svetoslav Mitov
  1. Add fieldreceiptId to Sessions / Listing resource [GET]
    1. receiptId
      string
      Description: ID of the receipt that is issued for the charging session.
  2. Utilities resource created and exposed via Public API
    The Utility resource will serve the purpose of categorising Charging Stations per "Utility Provider" entity, furthering the current split "per country" and "per state" for reporting purposes.
    1. resource / utilities
      Supported Methods: GET, POST, PUT, DELETE
      1. id
        integer, required
      2. name
        string, required
      3. createdAt
        string, date-time, required
        Description: ISO 8601 formatted date
  3. Expose Optimised Dynamic Pricing tariff in public API
    1. Properties:
      1. thresholdPriceForEnergy - number, decimal
      2. priceForEnergyWhenOptimized - number, decimal
      3. pricePerKwh - number, decimal
      4. minPrice - number, decimal
      5. connectionFee - number, decimal
      6. taxID - number
      7. preAuthorizeAmount - number, decimal
  4. Postal Code isoptional for country Israel (IL)

Release Notes: Public API 2.115.0

almost 2 years ago by Svetoslav Mitov
  1. Fix: Smart Charging property set to "Disabled" by default when new Charge Point is created usingCharge Point v2.0
  2. Fix: contractId is populated when declared in POST and PATCH requests for Charge Point v2.0
  3. AddedcircuitId to the Charge Point smartCharging object
    1. circuitId
      integer, optional, readonly
      Description: The ID of the DLM Circuit to which the charge point is added (if any).
  4. Enabled filtering bycircuitId in Charge Points endpoint
    1. *circuitId
      integer
      Description: Only list charge points added to a certain DLM Circuit

Release Notes: Public API 2.114.0

almost 2 years ago by Svetoslav Mitov
  1. Expose Firmware Update in action / charge point
    • PATH PARAMETERS
      chargePoint (required)
      integer
    • BODY SCHEMA
      url (required)
      string
      Description: Location (URL) from which to retrieve the firmware. retrieveAfter
      datetime
      Description: Specifies the date and time after which the Charge Point should retrieve the new firmware. If not provided, the current _datetime_ will be used.
      retries
      integer[0..10]
      Description: Specifies how many times the Charge Point must try to retrieve the (new) firmware before giving up.
      interval
      integer[0..3600]
      Description: The interval in seconds between each retry.
      signed (required)
      boolean
      Description: Indicates a Signed Firmware Update.
      signingCertificate
      string
      Description: Required if "signed" is true.
      signature
      string
      Description: Required if "signed" is true.

Release Notes: Public API 2.113.0

almost 2 years ago by Svetoslav Mitov
  1. Sending HardwareStatusNotificationOccupied instead ofPreparing
    • In order to comply with OCPP 2.0.1 implementations, Occupied status has been introduced (instead of Preparing status as per OCPP 1.6).

Release Notes: Public API 2.112.0

almost 2 years ago by Svetoslav Mitov
  1. New query parameter includePartnerInvite in the Users listing endpoint
    • include
      array of strings
      Items Value: partnerInvites
      Description: When used the User object will include an array of strings for the partner invites that the User has accepted.
  2. Version 2.0 of resource / Charge Points officially published
  3. Adapt web hooks to be able to produce Kafka events
  4. Fix: Deleted Location resource does not allow creation of a new Location ifexternalId values match.
    • Due to soft-deletion process for location resources, validation does not allow for the externalId property value to be duplicated. This has been fixed.

Release Notes: Public API 2.111.0

almost 2 years ago by Svetoslav Mitov
  1. Fix: Incorrect pagination for partner accounts in a single GET request
    • per_page parameter within resource / Partners / Listing endpoint failed to return the correct number of partner accounts when stated.
  2. Public API Documentation enhancement
    • Separate Authorisations resource from Sessions endpoint
    • Separate Template resource from the Charge Point endpoint
    • Remove Proposal resource

Release Notes: Public API 2.110.0

almost 2 years ago by Svetoslav Mitov
  1. Session start response codes - implement enums
    Endpoints affected:
    • https://{{baseUrl}}/public-api/actions/charge-point/v1.0/{{chargePoint}}/start/{{evse}}
    • https://{{baseUrl}}/public-api/actions/evse/v1.0/{{evse}}/start

Release Notes: Public API 2.109.0

almost 2 years ago by Svetoslav Mitov
  1. Public API Improvements to facilitate ISO 15118 functionalities:
    • Provisioning Certificates - expose object (List, Create, Read, Update)
      • name
        string, required
      • pcid
        string, required
      • vehicleType
        string, required
        enum: company, private
      • userId
        integer, required
    • Issue EMAID (Action)
      https://{{baseUrl}}/public-api/actions/provisioning-certificate/v1.0/{{provisioningCertificate}/issue-emaid
      Properties:
      • paymentMethod
        string
        description: The payment method that will be associated with the ID Tag.
        • For credit/debit cards the paymentMethodId should be provided
        • For Corporate billing - corporate:{id}
        • For last used the value should be null
    • Reissue EMAID (Action)
      https://{{baseUrl}}/public-api/actions/id-tag/v1.0/{idTag}/reissue-emaid

Release Notes: Public API 2.107.0

almost 2 years ago by Svetoslav Mitov
  1. Change Charge Point PIN with a PATCH request
    Fixed an issue where PIN property could not be updated to an existing Charge Point resource via API PATCH request: 
    curl --location --request PATCH 'https://{{baseUrl}}/public-api/resources/charge-points/v1.0/{{chargePointId}}' \
--header 'Content-Type: application/json' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {{bearerToken}}' \
--data '{
  "pin": "<string>"
}'