---
title: "Request clearance status a specific clearance"
method: GET
path: "/otpclearance/api/thirdparty/v1/applications/clearances/{clearanceId}"
tags: ["BMW CarData API (v1)"]
---

# Request clearance status a specific clearance

`GET /otpclearance/api/thirdparty/v1/applications/clearances/{clearanceId}`

## Request

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

Method to request the current status of a specific clearance.

## Path parameters

- `clearanceId` string, required

## Response `200`

The provided clearance status of a given clearanceId successfully

- ClearanceStatusResponseDO
  - `clearanceId` string: id of clearance
  - `clearanceState` 'REQUESTED' | 'APPROVED' | 'REJECTED' | 'REVOKED' | 'TIMED_OUT': status of clearance

## Other responses

- `400`: Format of parameter 'clearanceId' is invalid
- `401`: Unauthorized request. Please authorize using your API Key.
- `403`: Forbidden! No permission for specified 'clearanceId'.
- `404`: No permission for specified 'clearanceId'.
- `500`: An internal server 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)