AfroTools API

Overview

The AfroTools API provides programmatic access to African financial data: tax rates, exchange rates, salary benchmarks, and PAYE calculations across supported African markets.

Built for fintechs, HR platforms, payroll systems, accounting firms, and business media. Start with the free tier (100 requests/day and 3,000/month). Paid API Growth, API Pro, and Enterprise/custom access are manually activated commercial pilots.

Authentication

Include your API key in every request using one of these methods:

# Header (recommended)
x-api-key: afro_live_xxxxxxxxxxxxx

# Or query parameter
?api_key=afro_live_xxxxxxxxxxxxx

Example with cURL

curl "https://afrotools.com/api/v1/tax/rates?country=NG" \
  -H "x-api-key: YOUR_API_KEY"

Example with JavaScript

const res = await fetch('https://afrotools.com/api/v1/tax/rates?country=NG', {
  headers: { 'x-api-key': 'YOUR_API_KEY' }
});
const data = await res.json();

Example with Python

import requests

data = requests.get(
    "https://afrotools.com/api/v1/tax/rates",
    params={"country": "NG"},
    headers={"x-api-key": "YOUR_API_KEY"}
).json()

Rate Limits

Free keys are created from the API dashboard. Paid API Growth and API Pro limits can be applied manually during a pilot; request activation from API pricing.

Where a route exposes rate limit headers, they follow this shape. The dashboard is the main usage view:

X-RateLimit-Limit: 100
X-RateLimit-Remaining: 87

Limits reset at midnight UTC daily.

Status, Versioning, and Key Security

Error Codes

All errors return a JSON body with an error field:

{
  "error": "Invalid or missing API key",
  "code": "INVALID_API_KEY"
}

Tax Calculate (PAYE)

The most powerful endpoint — compute African PAYE without building your own engine. Supports gross-to-net and net-to-gross calculations for 53 countries.

Request Body

* Provide one of grossAnnual, grossMonthly, netAnnual, or netMonthly.

Example Request

curl -X POST "https://afrotools.com/api/v1/tax/paye" \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"country":"NG","grossAnnual":7200000}'

Example Response

{
  "status": "success",
  "input": { "country": "NG", "grossAnnual": 7200000, "regime": "NTA_2026" },
  "deductions": {
    "pension": 576000,
    "nhf": 180000,
    "totalDeductions": 1773600
  },
  "tax": {
    "taxableIncome": 6444000,
    "netTax": 1017600,
    "bands": [...]
  },
  "result": {
    "netAnnual": 5426400,
    "netMonthly": 452200,
    "effectiveRate": "14.13%"
  }
}

GET: List Supported Countries

curl "https://afrotools.com/api/v1/tax/paye" \
  -H "x-api-key: YOUR_API_KEY"

Tax Rates (Reference Data)

Static reference data — PAYE bands, VAT rates, and tax authority info for all African countries.

Parameters

Example Request

curl "https://afrotools.com/api/v1/tax/rates?country=NG" \
  -H "x-api-key: YOUR_API_KEY"

Example Response

{
  "country": "NG",
  "country_name": "Nigeria",
  "currency": "NGN",
  "tax_authority": "FIRS",
  "paye": {
    "regimes": ["PITA_2025", "NTA_2026"],
    "year": "2026",
    "source": "Federal Inland Revenue Service (FIRS)"
  },
  "vat": {
    "standard_rate": 0.075,
    "currency": "NGN"
  }
}

FX Rates

Exchange rates for African currencies with historical data support.

Parameters

Example Request

curl "https://afrotools.com/api/v1/fx/rates?base=USD&target=NGN" \
  -H "x-api-key: YOUR_API_KEY"

Example Response

{
  "base": "USD",
  "target": "NGN",
  "rate": 1580.50,
  "source": "CBN",
  "updated_at": "2026-03-19T08:00:00Z",
  "change_24h": -0.32
}

Salary Benchmarks

Salary benchmark data aggregated from AfroTools users.

Parameters

Example Response

{
  "country": "NG",
  "currency": "NGN",
  "period": "monthly",
  "sample_size": 1250,
  "gross": { "median": 450000, "p25": 250000, "p75": 800000 },
  "net": { "median": 375000, "p25": 220000, "p75": 680000 },
  "effective_tax_rate": 12.5
}

Countries

Reference data for all 54 African countries including currencies, regions, and available tools.

Parameters

Example Response (single country)

{
  "code": "NG",
  "name": "Nigeria",
  "currency": "NGN",
  "currency_symbol": "\u20a6",
  "region": "West Africa",
  "population": 230000000,
  "tools_available": ["paye", "vat", "fx"]
}

Get Your API Key

Enter your email to start signup. Keys are generated only after sign-in and email verification. Free tier includes 100 requests/day and 3,000/month.