UAE
Last updated
Was this helpful?
Last updated
Was this helpful?
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.
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.
Government database lookup API
Bearer token
yyyy-MM-dd
\d{4}-\d{2}-\d{2}ISO 3166-1 alpha-3 format