# UAE

## Emirates ID

{% openapi src="<https://id.uqudo.io/doc/v3/id-api/lookup>" path="/api/v2/id/lookup/uae/id" method="post" %}
<https://id.uqudo.io/doc/v3/id-api/lookup>
{% endopenapi %}

**Note**: Our API has a read timeout threshold of 35 seconds. To ensure you receive a proper response, we recommend setting your read timeout to at least 40 seconds, as this adds a small buffer for minor network or processing delays. Additionally, please be aware that if the target government service is unavailable or times out, our system will always return an HTTP 503 status code. It is important to handle this error appropriately in your implementation.

As a general best practice, for any HTTP 5xx status code, you should implement a retry mechanism with a short delay (a few seconds) before retrying. This approach helps mitigate temporary network disruptions and momentary unavailability of the government service. The same applies if your request times out without receiving a response.

#### Inherent unreliability of goverment services

Unfortunately, some government services are inherently unreliable, leading to unpredictable failures. There are no guaranteed SLAs, and the service may suffer from frequent, unplanned outages that can sometimes last several hours. In view of these challenges, we highly recommend using an asynchronous approach when integrating with this API:

* **Queue Requests:** Instead of making direct API calls, enqueue requests using a message queue (e.g., AWS SQS, RabbitMQ).
* **Asynchronous Processing:** Have worker nodes process requests asynchronously to minimize system load.
* **Background Retries:** Manage retries in the background so that users are not affected.
* **User Notifications:** Replace real-time validation with a message like, “Your application is being processed. You will receive an update shortly.”
* **Result Delivery:** Communicate results through push notifications or via Email/SMS updates.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.uqudo.com/docs/kyc/uqudo-api/lookup/uae.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
