---
title: "Request charging history data for a specific clearance."
method: GET
path: "/otpdatadelivery/api/thirdparty/v1/clearances/{clearanceId}/chargingHistory"
tags: ["BMW CarData API (v1)"]
---

# Request charging history data for a specific clearance.

`GET /otpdatadelivery/api/thirdparty/v1/clearances/{clearanceId}/chargingHistory`

## Request

- Base URL: `https://api.bmwgroup.com`
- URL: `https://api.bmwgroup.com/otpdatadelivery/api/thirdparty/v1/clearances/{clearanceId}/chargingHistory`
- Auth: API key in header `KeyId`

Method to request the charging history of a specific clearance.

## Path parameters

- `clearanceId` string, required

## Query parameters

- `nextToken` string, uuid
- `from` string, date-time, required
- `to` string, date-time

## Response `200`

A clearance specific list of charging history entries is returned, list can also be empty.

- ChargingHistoryResponseDO
  - `nextToken` string, uuid
  - `data` ChargingSessionDO[], required
    - `publicChargingPoint` PublicChargingPointDO
      - `potentialChargingPointMatches` PublicChargingPointMatchesDO[]
        - `postalCode` string
        - `streetAddress` string
        - `providerName` string
        - `city` string
    - `displayedSoc` integer
    - `displayedStartSoc` integer
    - `businessErrors` BusinessErrorDO[]
      - `creationTime` string, date-time
      - `hint` string
    - `timeZone` string
    - `startTime` integer: UTC time in seconds from 01.01.1970
    - `endTime` integer: UTC time in seconds from 01.01.1970
    - `totalChargingDurationSec` integer
    - `energyConsumedFromPowerGridKwh` number, float
    - `isPreconditioningActivated` boolean
    - `mileage` integer
    - `mileageUnits` 'KM' | 'MI'
    - `chargingCostInformation` ChargingCostInformationDO
      - `currency` string
      - `calculatedChargingCost` number, float
      - `calculatedSavings` number, float
    - `chargingLocation` ChargingLocationDO
      - `municipality` string
      - `formattedAddress` string
      - `streetAddress` string
      - `mapMatchedLatitude` number, float
      - `mapMatchedLongitude` number, float
    - `chargingBlocks` ChargingBlockDO[]
      - `startTime` integer: UTC time in seconds from 01.01.1970
      - `endTime` integer: UTC time in seconds from 01.01.1970
      - `averagePowerGridKw` number, float

## Other responses

- `400`: Bad request
- `401`: Unauthorized request. Please authorize using your API Key.
- `403`: Access forbidden
- `404`: Not found
- `429`: Too Many Requests
- `500`: Internal Server Error
- `503`: Service unavailable.

---

[API](https://skmtc.dev/bmwgroup/apis/bmw-cardata-api-specification.md) - [All operations](https://skmtc.dev/bmwgroup/apis/bmw-cardata-api-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/bmwgroup/apis/bmw-cardata-api-specification/revisions/3830455d6165?raw)