Finance

VAT Calculator API

Calculate Value Added Tax for all 6 GCC countries with current 2025 rates. Supports both exclusive (add VAT to amount) and inclusive (extract VAT from amount) calculation modes.

Endpoint:/api/v1/vat/calculate
Method:GET
Latency:~5ms

Try it out

GET/api/v1/vat/calculate

Parameters

Code

curl
curl -X GET "https://khaleejiapi.dev/api/v1/vat/calculate?amount=1000&country=AE&inclusive=false" \
-H "Authorization: Bearer your_api_key"

Parameters

ParameterTypeRequiredDescription
amountnumberRequiredThe monetary amount to calculate VAT for
countrystringOptionalGCC country code (AE, SA, BH, OM, KW, QA)
inclusivebooleanOptionalWhether the amount already includes VAT

GCC VAT Rates (2025)

CountryCodeVAT RateCurrency
UAEAE5%AED
Saudi ArabiaSA15%SAR
BahrainBH10%BHD
OmanOM5%OMR
KuwaitKW0%KWD
QatarQA0%QAR

Response Fields

country / countryName

Country code and English name

vatRate

Current VAT rate as percentage

baseAmount

Amount before VAT

vatAmount

Calculated VAT amount

totalAmount

Base amount + VAT amount

currency

Local currency code (AED, SAR, etc.)

Rate Limits

PlanRequests/MonthRate Limit
Free1,00010 req/min
Starter10,00060 req/min
Professional100,000300 req/min
Business500,0001,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.