Country Tax Service API Documentation

Comprehensive API for country tax information, shipping services, and regional data management.
Built with Laravel and designed for marketplace services.

🏛️

Tax Management

Complete VAT and tax rate management for all countries with real-time calculations

🚚

Shipping Services

Regional shipping services with cost calculations and delivery time estimates

🌍

Country Data

Comprehensive country information including currencies, languages, and address formats

🇹🇷

Turkey Focus

Specialized endpoints for Turkey's regions, provinces, and local shipping services

📋 Available Endpoints

🌍 Country Information

GET /api/v1/countries Get all countries

GET /api/v1/countries/{code} Get specific country

GET /api/v1/countries/{code}/currency Get country currency

GET /api/v1/countries/{code}/tax-info Get country tax information

💰 Tax Calculation

POST /api/v1/calculate-tax Calculate tax for amount

GET /api/v1/tax-rates/{country} Get tax rates by country

GET /api/v1/tax-types Get available tax types

💱 Currency & Exchange

GET /api/v1/currencies Get all currencies

GET /api/v1/exchange-rates Get exchange rates

POST /api/v1/convert-currency Convert currency

🏠 Address & Location

GET /api/v1/countries/{code}/provinces Get provinces by country

GET /api/v1/countries/{code}/provinces/{province}/districts Get districts by province

POST /api/v1/validate-address Validate address format

POST /api/v1/validate-postal-code Validate postal code

🇹🇷 Turkey Specific

GET /api/v1/turkey/regions Get Turkey regions

GET /api/v1/turkey/regions/{region}/provinces Get provinces by region

GET /api/v1/turkey/shipping-services Get shipping services

POST /api/v1/turkey/calculate-shipping-cost Calculate shipping cost

🏦 Bank & BIN

GET /api/v1/banks Get all banks

GET /api/v1/banks/{country} Get banks by country

GET /api/v1/bin-ranges Get BIN ranges

GET /api/v1/bin-lookup/{bin} Lookup BIN information

📊 System & Health

GET /api/v1/version Get API version info

GET /api/v1/health Health check

GET /api/v1/metrics System metrics

GET /api/v1/queue/status Queue status

🚀 Advanced API Features

🔐 Authentication

API Key authentication with rate limiting and security headers for secure access

📊 Real-time Data

Live currency exchange rates, tax updates, and shipping cost calculations

🌐 Multi-language

Support for multiple languages and localized responses for global markets

⚡ High Performance

Redis caching, optimized queries, and sub-second response times

📈 Analytics

Built-in metrics, monitoring, and performance tracking capabilities

🔄 Webhooks

Real-time notifications for data updates and system events

⚡ Quick Start Guide

Get started with the Country Tax Service API in minutes

1. Get API Information

# Get API version and features
                curl -X GET https://pazaryeri.nlksoft.com/country-tax/api/v1/version
            

2. List All Countries

# Get all supported countries
                curl -X GET https://pazaryeri.nlksoft.com/country-tax/api/v1/countries
            

3. Calculate Tax

# Calculate VAT for Turkey
                curl -X POST https://pazaryeri.nlksoft.com/country-tax/api/v1/calculate-tax \
  -H "Content-Type: application/json" \
  -d '{
    "country_code": "TR",
    "amount": 1000,
    "tax_type": "vat"
  }'
            

4. Get Turkey Regions

# Get Turkey's regional data
                curl -X GET https://pazaryeri.nlksoft.com/country-tax/api/v1/turkey/regions
            

5. Health Check

# Check service health
                curl -X GET https://pazaryeri.nlksoft.com/country-tax/api/v1/health
            