API Documentation

Integrate GulfTaxes digital tax services into your applications with our comprehensive REST API.

Getting Started

Base URL

https://api.gulftaxes.com/v1

The GulfTaxes API is organized around REST. Our API has predictable resource-oriented URLs, accepts form-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes.

Authentication

The GulfTaxes API uses API keys to authenticate requests. You can view and manage your API keys in the Dashboard.

Example Request

curl https://api.gulftaxes.com/v1/tools/vat/calc \
  -H "Authorization: Bearer sk_test_..." \
  -H "Content-Type: application/json"

Tax Calculators

VAT Calculator

Calculate VAT for transactions across GCC countries.

POST/tools/vat/calc

Request Body

{
  "country": "uae",
  "amount": 1000,
  "vatType": "standard",
  "includesVat": false
}

Response

{
  "country": "uae",
  "baseAmount": 1000,
  "vatRate": 5,
  "vatAmount": 50,
  "totalAmount": 1050,
  "currency": "AED",
  "calculation": {
    "method": "exclusive",
    "formula": "base * (1 + rate/100)"
  }
}

Corporate Tax Calculator

Calculate corporate tax liability with country-specific rules and deductions.

POST/tools/ct/calc

Request Body

{
  "country": "uae",
  "revenue": 5000000,
  "expenses": [
    {
      "category": "salaries",
      "amount": 1000000,
      "description": "Employee salaries"
    },
    {
      "category": "rent",
      "amount": 200000,
      "description": "Office rent"
    }
  ]
}

Response

{
  "country": "uae",
  "grossRevenue": 5000000,
  "totalDeductions": 1200000,
  "taxableIncome": 3800000,
  "taxRate": 9,
  "taxLiability": 342000,
  "currency": "AED",
  "breakdown": {
    "allowedDeductions": 1200000,
    "disallowedDeductions": 0,
    "adjustments": 0
  }
}

Country Data

Access comprehensive tax information, rates, and regulations for all GCC countries.

GET/country/content?country=uae

Response

{
  "country": "uae",
  "capabilities": {
    "hasVat": true,
    "hasCorporateTax": true,
    "hasExciseTax": true,
    "hasWithholdingTax": true
  },
  "facts": [
    {
      "label": "VAT Rate",
      "value": "5%"
    },
    {
      "label": "Corporate Tax Rate",
      "value": "9%"
    }
  ],
  "pricing": {
    "currency": "AED",
    "symbol": "د.إ",
    "decimals": 2
  }
}

Rate Limits

The GulfTaxes API implements rate limiting to ensure fair usage and system stability.

Rate Limit Headers

X-RateLimit-Limit: The maximum number of requests per hour
X-RateLimit-Remaining: The number of requests remaining in the current window
X-RateLimit-Reset: The time when the rate limit window resets

Error Handling

GulfTaxes uses conventional HTTP response codes to indicate the success or failure of an API request.

400 - Bad Request

The request was unacceptable, often due to missing a required parameter.

401 - Unauthorized

No valid API key provided.

429 - Too Many Requests

Too many requests hit the API too quickly.

500 - Server Error

Something went wrong on our end.

SDKs & Libraries

Official SDKs and community libraries to integrate GulfTaxes API into your applications.

Node.js

npm install @gulftaxes/node

View Documentation →

Python

pip install gulftaxes

View Documentation →

Ready to Get Started?

Get API Key Contact Sales