UAE EID Fine Enquiry Check - Get Data

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

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

{
    "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"
        }
    }
}

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

{
  "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.

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 [email protected]. 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!