Emirate codes

Use this page to fill country_subentity in a UAE address.

This page uses these terms:

  • UAE address: an address in which country is AE. AE is also the default value of country.
  • Emirate code: the 3-letter code of an emirate.

For a UAE address, country_subentity must contain one of these codes:

CodeEmirate
AUHAbu Dhabi
DXBDubai
SHJSharjah
AJMAjman
UAQUmm Al Quwain
RAKRas Al Khaimah
FUJFujairah

Send the code in capital letters. If your app sends the name of the emirate in English or Arabic, or its ISO 3166-2 code, Wafeq e-invoicing ASP converts it to the code. For example, Dubai, دبي and AE-DU all become DXB, and the response and the e-invoice show DXB.

Wafeq ASP refuses a UAE address without an emirate, or with any other value, with HTTP 422 and the code invalid_emirate, before it validates or sends the document. A check of the document gives the same code in errors. Values such as AE, UAE or the name of a city are refused. If the address is outside the UAE, send its country code in country.

Replaying a completed request with the same Idempotency-Key still returns its original response.

A void copies the buyer of the invoice, so it is not refused for an address that Wafeq ASP accepted earlier. From 3 December 2026, the official rules also check that address. If they refuse it, issue the credit note with POST /credit-notes, previous_document_id and the corrected address.

Where the codes apply

  • customer.address, when the buyer is in the UAE. Refer to Submit a document.
  • delivery_address, when the delivery is in the UAE, for example on an e-commerce sale. Refer to Special scenarios.
  • supplier.address on a self-billed document, when the seller is in the UAE.
  • The address of the taxpayer. The taxpayer gives its emirate when it connects. Wafeq ASP takes the address from the profile of the taxpayer. Your app does not send it.

Addresses outside the UAE

For an address outside the UAE, country_subentity is the region, for example a state, a province or a county. Use the name that the address uses. The UAE rules need it in the address of each buyer.


Emirate codes