VAT Validation API
Multi-GCC VAT/TIN validation for UAE, Saudi Arabia, Bahrain, and Oman. Includes check digit verification, authority info, and tax rate details.
/api/v1/vat/validateTry it out
/api/v1/vat/validateParameters
Code
curl -X GET "https://khaleejiapi.dev/api/v1/vat/validate?tin=100234567890003" \ -H "Authorization: Bearer your_api_key"Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| tin | string | Required | Tax identification number (also accepts 'trn' or 'vat' as alias) |
| country | string | Optional | Country code: AE, SA, BH, OM (auto-detected if omitted) |
Response Fields
valid, reason
Boolean validity and human-readable reason
country, countryCode, countryAr
Detected country in English, ISO code, and Arabic
type, typeAr
Tax registration type in English and Arabic
details
Check digit validity, format, VAT rate, effective date, taxing authority name/URL
Rate Limits
| Plan | Requests/Month | Rate Limit |
|---|---|---|
| Free | 1,000 | 10 req/min |
| Starter | 10,000 | 60 req/min |
| Professional | 100,000 | 300 req/min |
| Business | 500,000 | 1,000 req/min |
Debugging & Support
Include X-Request-ID when contacting support
Every response from KhaleejiAPI includes an X-Request-ID header — a unique identifier that lets our support team pull the exact log entry for your request within seconds. Always share it when reporting an unexpected error or unexpected result.
How to capture it
JavaScript / fetch
const res = await fetch("https://khaleejiapi.dev/api/v1/...", {
headers: { Authorization: "******" },
});
const requestId = res.headers.get("x-request-id");
console.log("Request ID:", requestId);
// → e.g. "req_01j9xkz4vp8..."cURL
curl -si "https://khaleejiapi.dev/api/v1/..." \ -H "Authorization: ******" | grep -i x-request-id # → x-request-id: req_01j9xkz4vp8...
Browser DevTools
Open DevTools (F12) → Network tab → click the failing request → scroll to the Response Headers section → copy the value next to x-request-id.
For a full list of error codes and guidance on common issues, see the Troubleshooting guide.