---
title: "Request diagnostic trouble codes (DTC) data for a specific clearance."
method: GET
path: "/otpdatadelivery/api/thirdparty/v1/clearances/{clearanceId}/dtcReadoutConfirmed"
tags: ["BMW CarData API (v1)"]
---

# Request diagnostic trouble codes (DTC) data for a specific clearance.

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

## Request

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

The 3rd party calls this method to request a DTCs of a specific clearance.

## Path parameters

- `clearanceId` string, required

## Response `200`

A clearance specific list of confirmed DTCs is returned, list can also be empty.

- DTCResponseDO
  - `asyncStatus` string
  - `messageTimestamp` string: Timestamp when the data in the message was received
  - `vehicleId` string: Is the specified clearanceId
  - `dtcData` DTCResponseDataDO[]: List of confirmed DTC(s) or empty list.
    - `ecuAddress` string: Identifier of the ECU address where the DTC occurred
    - `ecuVariantName` string: Identifier of the ECU variant where the DTC occurred, ISO20080 compliant property name.
    - `dtcId` string: Identifier of the DTC. ISO20080 compliant property name. Hexadecimal formatted value.
    - `status` 'ACTIVE' | 'PENDING' | 'PREVIOUSLY_ACTIVE': Reflects the status of the DTC. ISO20080 compliant property name.

## Other responses

- `400`: Bad request
- `401`: Unauthorized
- `403`: Access forbidden
- `404`: Not found
- `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)