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

# Request telematic data for a specific clearance

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

## Request

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

The 3rd party calls this method to request telematic data of a specific clearance, for the specified vehicle. If the OTP 3rd Party API decides that the telematic data can be delivered immediately (synchronous) this method returns the telematic key/value datastructure otherwise this method returns a requestId for later retrieval.

## Path parameters

- `clearanceId` string, required

## Response `200`

A clearance specific list of telematic key and values was returned.

- ThirdpartyFetchDataResponseDO
  - `telematicKeyValues` TelematicKeyValueDO[]: This is the list of the telematic key values
    - `name` string
    - `value` string
    - `unit` string
    - `timestamp` string
  - `asyncResponse` TelematicKeyValueAsyncResponseDO
    - `requestId` string
    - `fetchIn` integer
    - `timeToLive` integer

## Other responses

- `202`: Creation of the response took too long. Request is processed asychronously.
- `401`: Unauthorized request. Please authorize using your API Key.
- `403`: Not allowed to fetch telematic data.
- `412`: Not allowed to fetch telematic data.
- `500`: Internal error occurred

---

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