> For the complete documentation index, see [llms.txt](https://docs.tutelar.io/tutelar-api-document/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.tutelar.io/tutelar-api-document/tutelar-api-document-v2/kyc-verification/document-verification/uae/uae-dubai-vehicle-challan.md).

# UAE Dubai Vehicle Challan

The Dubai Vehicle Challan API allows users to retrieve details of traffic violations (challans) issued to vehicles registered in Dubai.

## dubai\_vehicle\_challan

<mark style="color:green;">`POST`</mark> `https://secctrl.tutelar.io/api/v2/kyc/utility/dubai_vehicle_challan`

### Header

| Name          | Value                     |
| ------------- | ------------------------- |
| Content-Type  | `application/json`        |
| Authorization | `Bearer eyJhbGciOiJ.....` |

### Post parameters description is given below,

<table><thead><tr><th width="197">Post Parameter </th><th width="139">Type</th><th>Is  Mandatory</th><th width="235.63671875">Description</th></tr></thead><tbody><tr><td>traffic_file_number </td><td>String </td><td>Yes </td><td>Traffic File Number</td></tr></tbody></table>

#### Sample Post Parameters

```json
{
    "traffic_file_number": "12367950"
}
```

{% tabs %}
{% tab title="200: Success Response" %}

```json
{
    "success": true,
    "code": 200,
    "message": "The request has been successfully completed.",
    "reference_id": "3a3095ec-2144-4212-ab84-c0419cf2140f",
    "status": "completed",
    "result": {
        "trafficFileNumber": "12367950",
        "numberOfChallan": "5",
        "totalAmount": "690.0"
    },
    "requested_at": "2026-01-27T08:53:04.074Z",
    "completed_at": "2026-01-27T05:45:23.360Z"
}
```

{% endtab %}

{% tab title="200: InProgress Response" %}

```json
{
    "success": true,
    "code": 200,
    "message": "The request is being processed. Please wait for completion.",
    "reference_id": "d63508d8-9e04-49ec-925c-e1912d6a0007",
    "status": "in_progress",
    "requested_at": "2026-01-27T11:44:58.057Z"
}
```

{% endtab %}

{% tab title="400: Validation Error Response" %}

```json
{
    "success": false,
    "code": 400,
    "message": "Invalid input. Please check your request and try again.",
    "error": {
        "message": "Traffic File Number should not be empty",
        "field": "traffic_file_number",
        "code": "BAD_REQUEST"
    }
}
```

{% endtab %}

{% tab title="200: Failure Response" %}

```json
{
    "success": true,
    "code": 200,
    "message": "The request could not be completed due to an error.",
    "reference_id": "e6603867-f2e2-47e2-a89d-b790321748d6",
    "status": "failed",
    "error": {
        "message": "Data not Found for this trafficFileNumber",
        "code": "ERROR"
    },
    "requested_at": "2026-01-27T08:53:04.074Z",
    "completed_at": "2026-01-27T05:42:41.225Z"
},
{
  "success": true,
  "code": 200,
  "message": "The request could not be completed due to an error.",
  "reference_id": "88fe20fc-210d-4fc3-9a38-5d32589c2d6e",
  "status": "failed",
  "error": {
    "message": "\"trafficFileNumber\" length must be 8 characters long",
    "code": "ERROR"
  },
  "requested_at": "2026-01-27T14:04:48.448Z",
  "completed_at": "2026-01-27T14:04:48.882Z"
}
```

{% endtab %}
{% endtabs %}

#### Check Document Status

## Get document details

<mark style="color:blue;">`GET`</mark> `https://secctrl.tutelar.io/api/v2/kyc/utility/dubai_vehicle_challan`

### Query parameters description is given below,

<table><thead><tr><th width="197">Query Parameter </th><th width="139">Type</th><th>Is  Mandatory</th><th>Description</th></tr></thead><tbody><tr><td>reference_id </td><td>String </td><td>Yes </td><td>Document reference id</td></tr></tbody></table>

{% tabs %}
{% tab title="200: Success Response" %}

```json
{
    "success": true,
    "code": 200,
    "message": "The request has been successfully completed.",
    "reference_id": "3a3095ec-2144-4212-ab84-c0419cf2140f",
    "status": "completed",
    "result": {
        "trafficFileNumber": "12367950",
        "numberOfChallan": "5",
        "totalAmount": "690.0"
    },
    "requested_at": "2026-01-27T08:53:04.074Z",
    "completed_at": "2026-01-27T05:45:23.360Z"
}
```

{% endtab %}

{% tab title="200: InProgress Response" %}

```json
{
    "success": true,
    "code": 200,
    "message": "The request is being processed. Please wait for completion.",
    "reference_id": "d63508d8-9e04-49ec-925c-e1912d6a0007",
    "status": "in_progress",
    "requested_at": "2026-01-27T11:44:58.057Z"
}
```

{% endtab %}

{% tab title="200: Failure Response" %}

```json
{
    "success": true,
    "code": 200,
    "message": "The request could not be completed due to an error.",
    "reference_id": "e6603867-f2e2-47e2-a89d-b790321748d6",
    "status": "failed",
    "error": {
        "message": "Data not Found for this trafficFileNumber",
        "code": "ERROR"
    },
    "requested_at": "2026-01-27T08:53:04.074Z",
    "completed_at": "2026-01-27T05:42:41.225Z"
},
{
  "success": true,
  "code": 200,
  "message": "The request could not be completed due to an error.",
  "reference_id": "88fe20fc-210d-4fc3-9a38-5d32589c2d6e",
  "status": "failed",
  "error": {
    "message": "\"trafficFileNumber\" length must be 8 characters long",
    "code": "ERROR"
  },
  "requested_at": "2026-01-27T14:04:48.448Z",
  "completed_at": "2026-01-27T14:04:48.882Z"
}
```

{% endtab %}
{% endtabs %}
