API Reference

Authenticate user and return access token.

{
  "email": "user@example.com",
  "password": "password123"
}

{
  "success": true,
  "token": "eyJhbGciOiJIUzI1NiIs...",
  "user": {
    "id": "123",
    "email": "user@example.com",
    "role": "user"
  }
}

Get VAT settings for all countries or specific country.

{
  "countries": [
    {
      "code": "uae",
      "name": "United Arab Emirates",
      "vatRate": 5,
      "currency": "AED",
      "threshold": 375000,
      "filingPeriod": "quarterly"
    }
  ]
}

Calculate VAT for a transaction.

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

{
  "country": "uae",
  "baseAmount": 1000,
  "vatRate": 5,
  "vatAmount": 50,
  "totalAmount": 1050,
  "currency": "AED",
  "formatted": {
    "base": "AED 1,000.00",
    "vat": "AED 50.00",
    "total": "AED 1,050.00"
  }
}

Calculate corporate tax liability with deductions and adjustments.

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

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

Get comprehensive country-specific tax information.

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

Export calculation results as PDF report.

{
  "type": "vat",
  "data": {
    "country": "uae",
    "amount": 1000,
    "vatAmount": 50,
    "totalAmount": 1050
  },
  "format": "detailed"
}

{
  "success": true,
  "downloadUrl": "https://api.gulftaxes.com/files/report_123.pdf",
  "expiresAt": "2025-01-15T10:30:00Z",
  "fileSize": 245760,
  "hash": "sha256:abc123..."
}

Get country tax capabilities and regime settings.

{
  "countries": [
    {
      "country_slug": "uae",
      "has_vat": true,
      "has_corporate_tax": true,
      "has_excise_tax": true,
      "has_withholding_tax": true,
      "has_einvoicing": true
    }
  ]
}

Create or update country-specific content.

{
  "country_slug": "uae",
  "content_type": "facts",
  "data": {
    "label": "VAT Rate",
    "value": "5%",
    "description": "Standard VAT rate"
  }
}

{
  "success": true,
  "id": "fact_123",
  "message": "Content created successfully"
}

Get available expense natures for corporate tax calculations.

{
  "natures": [
    {
      "id": "salaries",
      "name": "Salaries and Wages",
      "category": "personnel",
      "deductible": true
    },
    {
      "id": "rent",
      "name": "Office Rent",
      "category": "operational",
      "deductible": true
    }
  ]
}

Process corporate tax rules and deductions.

{
  "country": "uae",
  "expenses": [
    {
      "nature": "meals",
      "amount": 10000,
      "description": "Business meals"
    }
  ]
}

{
  "processed_expenses": [
    {
      "nature": "meals",
      "original_amount": 10000,
      "allowable_amount": 5000,
      "rule_applied": "50% limitation",
      "citation": "UAE CT Law Article 15"
    }
  ]
}

Save corporate tax calculation scenario for future reference.

{
  "name": "Q4 2024 Calculation",
  "country": "uae",
  "revenue": 5000000,
  "expenses": [...],
  "user_id": "user_123"
}

{
  "success": true,
  "scenario_id": "scenario_456",
  "share_url": "/ct/scenario/scenario_456"
}

Calculate excise tax for tobacco, carbonated drinks, and energy drinks.

{
  "country": "uae",
  "products": [
    {
      "category": "tobacco",
      "quantity": 1000,
      "unit": "pack",
      "price_per_unit": 25
    }
  ]
}

{
  "country": "uae",
  "total_excise_tax": 25000,
  "products": [
    {
      "category": "tobacco",
      "excise_rate": "100%",
      "excise_amount": 25000,
      "total_with_excise": 50000
    }
  ]
}

Get e-invoicing requirements and compliance status by country.

{
  "country": "saudi",
  "business_type": "b2b",
  "annual_revenue": 5000000
}

{
  "country": "saudi",
  "einvoice_required": true,
  "implementation_phase": "Phase 2",
  "compliance_deadline": "2024-01-01",
  "portal_url": "https://zatca.gov.sa",
  "requirements": [
    "Real-time integration",
    "Digital signatures",
    "QR code generation"
  ]
}

Get platform usage analytics and calculation statistics.

{
  "total_calculations": 15420,
  "active_users": 1250,
  "popular_tools": [
    {"tool": "vat_calculator", "usage": 8500},
    {"tool": "ct_calculator", "usage": 4200},
    {"tool": "excise_calculator", "usage": 2720}
  ],
  "country_breakdown": {
    "uae": 6500,
    "saudi": 4200,
    "qatar": 2100,
    "oman": 1500,
    "bahrain": 800,
    "kuwait": 320
  }
}

Get SEO metadata and structured data for country pages.

{
  "country": "uae",
  "page_type": "country_landing"
}

{
  "title": "UAE Tax Advisory Services | GulfTaxes",
  "description": "Expert UAE tax advisory...",
  "canonical": "https://gulftaxes.com/countries/uae",
  "structured_data": {
    "@type": "Organization",
    "name": "GulfTaxes UAE",
    "serviceArea": "United Arab Emirates"
  },
  "hreflang": [
    {"lang": "en", "url": "/countries/uae"},
    {"lang": "ar", "url": "/ar/countries/uae"}
  ]
}