---
title: UAE EID Fine Enquiry Check - Get Data
slug: us-apis/uae-eid-fine-enquiry-check-get-data
createdAt: 2026-07-14T18:08:43.250Z
---

# Overview & Purpose

The **EID Fine Enquiry – Get Data API** retrieves the result of a fine enquiry that was previously started via the **EID Fine Enquiry – Initiate Request** API. It serves as the pull/fallback mechanism for the asynchronous flow: if no callbackUrl was provided at initiation, or the callback was not received, you can call this endpoint with the requestId at any time to fetch the latest state.

The response returns the current status of the request. While processing, statusCode will be 102 (PROCESSING) and output will not yet be present. Once complete, the output object contains the fine details (fineFound, fineDays, fineAmount).

This API is useful for individuals and organizations needing to verify the fine status of an Emirates ID. It can be integrated into systems for background checks, compliance verification, and other administrative processes where fine status information is required.

### API Input

:::CodeblockTabs
Preproduction

```curl
curl --location 'https://api-preproduction.signzy.app/api/v3/uae-api/eid-fine-enquiry-get-data' \
--header 'Content-Type: application/json' \
--header 'Authorization: <auth_token>' \
--data '{
    "requestId": "<request_id>"
}'
```

Production

```curl
curl --location 'https://api.signzy.ae/api/v3/uae-api/eid-fine-enquiry-get-data' \
--header 'Content-Type: application/json' \
--header 'Authorization: <auth_token>' \
--data '{
    "requestId": "<request_id>"
}'
```
:::

### API Input Mapping

| Input     | Data Type | Mandatory/Optional | Description                                                                                            |
| --------- | --------- | ------------------ | ------------------------------------------------------------------------------------------------------ |
| requestId | String    | Mandatory          | The unique request ID returned by the Initiate Request API. Must be a 24-character hexadecimal string. |

### API Response

:::CodeblockTabs
Data Found

```json
{
    "result": {
        "requestId": "<request_id>",
        "input": {
            "emiratesIdNumber": <emirates_id_number>,
            "dateOfBirth": "yyyy-mm-dd",
            "gender": "male",
            "callbackUrl": "https://your-domain.com/callback"
        },
        "statusCode": 200,
        "status": "SUCCESS",
        "message": "EID Fine Enquiry Details Found",
        "output": {
            "fineFound": true,
            "fineDays": "460",
            "fineAmount": "23000 dirham"
        }
    }
}
```

Upstream Down

```json
{
    "result": {
        "requestId": "<request_id>",
        "input": {
            "emiratesIdNumber":<emirates_id_number>,
            "dateOfBirth": "yyyy-mm-dd",
            "gender": "male",
            "callbackUrl": "https://your-domain.com/callback"
        },
        "statusCode": 409,
        "status": "FAILURE",
        "message": "Upstream is Down"
    }
}
```

Processing

```json
{
    "result": {
        "requestId": "665f1a2b3c4d5e6f7a8b9c0d",
        "input": {
            "emiratesIdNumber": <emirates_id_number>,
            "dateOfBirth": "yyyy-mm-dd",
            "gender": "male",
            "callbackUrl": "https://your-domain.com/callback"
        },
        "statusCode": 102,
        "status": "PROCESSING"
    }
}
```
:::

### API Output Mapping

| Field      | Data Type | Description                                                                                                    |
| ---------- | --------- | -------------------------------------------------------------------------------------------------------------- |
| requestId  | String    | The request ID for which data is being fetched.                                                                |
| input      | Object    | The original input submitted in the Initiate Request API (emiratesIdNumber, dateOfBirth, gender, callbackUrl). |
| statusCode | Number    | Status code of the request. 200 = success, 102 = still processing, 404 = data not found, 409 = upstream error. |
| status     | String    | Overall status: SUCCESS, PROCESSING, or FAILURE.                                                               |
| message    | String    | Human-readable message describing the current status (e.g. EID Fine Enquiry Details Found, Data Not Found).    |
| output     | Object    | Present only on success. Contains the fine enquiry result (see below).                                         |

**output object**

| Field      | Data Type | Description                                                 |
| ---------- | --------- | ----------------------------------------------------------- |
| fineFound  | Boolean   | Indicates whether a fine is found for the EID (true/false). |
| fineDays   | String    | The number of days the fine has been active.                |
| fineAmount | String    | The total fine amount in dirhams.                           |

### Error Code Response & Mapping

:::CodeblockTabs
400 (Bad Request)

```json
{
    "error": {
        "name": "error",
        "message": "Bad Request. RequestId is invalid.",
        "status": 400,
        "reason": "VALIDATION_ERROR",
        "type": "Bad Request",
        "statusCode": "400"
    }
}
```

400 (Bad Request)

```json
{
    "error": {
        "name": "error",
        "message": "RequestId Not Found",
        "status": 400,
        "reason": "BAD_REQUEST",
        "type": "Bad Request",
        "statusCode": "400"
    }
}
```

409 (Upstream Down)

```json
{
  "error": {
     "name": "error",
     "message": "Upstream down",
     "status": 409,
     "reason": "ERROR",
     "type": "Conflict",
     "statusCode": "409"
  }
}
```
:::

| Field        | Type   | Description                                         |
| ------------ | ------ | --------------------------------------------------- |
| `name`       | string | Text displayed on the screen explaining error type. |
| `reason`     | string | Reason for the error.                               |
| `status`     | number | HTTP status code.                                   |
| `message`    | string | Error message indicating an upstream error.         |
| `type`       | string | Error type.                                         |
| `statusCode` | string | Status code representing the error scenario.        |

:::hint{type="info"}
### Getting help

Please feel free to contact us if you have any questions, require clarification, or have ideas for how to make the documents or any of our services better.

You can reach out to us at [help@signzy.com](#). We strive to provide prompt and reliable assistance, ensuring your queries are addressed effectively.

We value your feedback and are committed to making your experience smooth and enjoyable. Our team is dedicated to assisting you with any needs you may have. Thank you for choosing our services. We look forward to helping you!
:::

