Africa Compliance Data API
Every value cites its source: official texts first; secondary sources, press reports and estimates are labelled, with a confidence level. Every response…
Productivity & workspace#calendar
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
Every value cites its source: official texts first; secondary sources, press reports and estimates are labelled, with a confidence level. Every response states the coverage of the country for that feature (ready, partial or gap). Finance-law digests are unofficial summaries; the cited law prevails. Plans: Free includes the country list, holidays, business days, calendar feeds and the account endpoint; Developer adds commercial use, the holiday watch and webhooks for holiday changes; Essentials and Pro add VAT (with the rate on a date and the rate history), withholding tax (with treaty rates and the calculation on a payment), tax treaties, tax ID checks and rules, filing deadlines, e-invoicing requirements and payroll data for the countries of their country pack (Essentials 1, Pro 5, plus extra countries bought as add-ons); Compliance covers all 54 countries and adds finance-law digests and webhooks for every change. An endpoint outside the key's plan, or tax data outside an Essentials or Pro key's pack, returns 403 with a message. Monthly quotas per key and calendar month (UTC): Free 3,000, Developer 50,000, Essentials 100,000, Pro 250,000, Compliance 1,000,000 successful requests; counted answers carry X-Quota-Limit and X-Quota-Remaining, and over the quota the API answers 429 until the 1st. Subscriptions started before 20 October 2026 keep their plan and price (no monthly quota). Rate limits per key and minute: Free 30, Developer 60, Essentials 60, Pro 300, Compliance 1,000; full country profiles and the holiday watch also share a limit of 5 per minute. Reference data compiled mainly from official sources, not legal or tax advice. Africa Compliance Data is independent and is not affiliated with or endorsed by any government or tax authority.
Status without a key: GET https://api.africacompliancedata.com/health returns {name, dataset_version, data_revision, docs, mcp}.
Get a key: https://africacompliancedata.com/#pricing · Docs: https://africacompliancedata.com/docs · MCP server: https://api.africacompliancedata.com/mcp
Endpoints 31
Countries
- GETYour key: plan, status, monthly quota, country pack, rate limit and today's usage
/v1/accountDaily allowances count distinct countries read per UTC day. Not counted against the monthly quota, and not a country read. - GETYour country pack: the countries of tax data, and when it can next be swapped. Essentials and Pro plans
/v1/account/countriesNot counted against the monthly quota. The first countries an Essentials or Pro key requests tax data for join the pack while it has room. - POSTSet your country pack. Essentials and Pro plans
/v1/account/countriesAdding countries to free places is always possible. A change that removes a country (a swap) is possible once every 30 days (409 with next_swap_from and… - GETList the 54 countries with currency and coverage per feature
/v1/countriesOn Free and Developer, coverage lists only the holiday features. - GETFull compliance profile of one country
/v1/countries/:countryShares the per-key limit of 5 requests per minute with the holiday watch. Tax sections need the Compliance plan, or the Essentials or Pro plan for a country…
Holidays and business days
- GETAnnounced and moon-sighted holidays across countries, estimated or confirmed. Developer, Essentials, Pro and Compliance (all countries)
/v1/holidays/watchHolidays whose date depends on an announcement (Eid, Mawlid and other moon-sighted holidays, ad-hoc days off) from 7 days ago to days ahead, with status… - GETPublic holidays of a year
/v1/countries/:country/holidays?year=2026National holidays with status: rule, confirmed, estimated (moon-sighted; a reviewer publishes the confirmed date once the announcement is verified, delays are… - GETHolidays as an iCalendar feed
/v1/countries/:country/holidays.icsSubscribable calendar (RFC 5545): one all-day event per holiday. Estimated dates are TENTATIVE and keep the same UID, so subscribed calendars move them once a… - GETIs a date a working day?
/v1/countries/:country/is-business-day?date=2026-12-24 - GETWorking days between two dates (both included)
/v1/countries/:country/business-days?from=2026-12-01&to=2026-12-31 - GETThe date N working days later (or earlier)
/v1/countries/:country/add-business-days?date=2026-12-24&days=5
Tax data
- GETVAT rates, registration threshold and legal basis (and the standard rate on a date). Essentials and Pro (countries of their pack) and Compliance
/v1/countries/:country/vatWith date, also standard_rate_on_date: the standard rate in force that day, from the dated history. The history starts at its covered_from date (usually… - GETStandard VAT rate history (dated periods with the law that set each rate). Essentials and Pro (countries of their pack) and Compliance
/v1/countries/:country/vat/historyCoverage starts at the history's covered_from date (usually 2015-01-01) or at the earliest period backed by an official source; a period that began earlier… - GETWithholding tax rates (resident and non-resident), with treaty rates for a recipient's country. Essentials and Pro (countries of their pack) and Compliance
/v1/countries/:country/withholding-tax - GETWithholding tax on one payment: the rate that applies (domestic, or the treaty maximum if lower), the amount withheld and the net payment. Essentials and Pro (countries of their pack) and Compliance
/v1/countries/:country/withholding-tax/calculate?payment_type=dividends&amount=10000&recipient_country=AEThe paying country is {country}; the recipient is resident in recipient_country (the paying country itself for a resident recipient: resident rate, no… - GETE-invoicing or fiscalisation requirement: system, status, dated phases, legal basis and the tax authority's list of accredited integrators. Essentials and Pro (countries of their pack) and Compliance
/v1/countries/:country/e-invoicingstatus: mandatory, phased (in force for some groups, dates for others), voluntary, pilot, planned (legislated or announced, not in force), unclear (a system… - GETTax treaty maximum withholding rates of the paying country, per partner. Essentials and Pro (countries of their pack) and Compliance
/v1/countries/:country/treatiesWhich countries have treaty data: coverage.treaties in /v1/countries. Without data, or without a treaty with the partner asked, the list is empty and warning… - GETLatest finance law: business-relevant changes. Compliance plan only
/v1/countries/:country/finance-lawWhich countries have a digest: coverage.finance_law in /v1/countries. For the others finance_law is null and warning says so. A digest is an unofficial… - GETIncome tax bands on employment income (PAYE) for resident employees, in dated periods. Essentials and Pro (countries of their pack) and Compliance
/v1/countries/:country/payroll-taxThe bands, tax-free threshold and reliefs in force on 'date' (default today) as payroll_tax.in_force, and every dated period in 'periods' (oldest first; the… - GETStatutory contributions on pay (pension, social security, health, housing, levies), in dated periods. Essentials and Pro (countries of their pack) and Compliance
/v1/countries/:country/social-securityOne item per scheme or branch, with the period in force on 'date' (default today) as in_force and every dated period. Rates are percentages of 'base';… - GETDeprecated (ends 31 December 2026): check a tax ID's format, value in the URL. Use POST. Essentials and Pro (countries of their pack) and Compliance
/v1/countries/:country/tax-id/validate?value=stringDeprecated. Deprecated since 20 October 2026; removed after 31 December 2026. Use the POST operation, or check locally with the signed rules (GET… - POSTCheck a tax ID's format (not its registration), value in the body (recommended). Essentials and Pro (countries of their pack) and Compliance
/v1/countries/:country/tax-id/validateChecks the format (and the check digit where its algorithm is published). Does not confirm registration. The value is sent in the JSON body, so it stays out… - GETSigned tax ID format rules, to check numbers on your own machine. Essentials and Pro (countries of their pack) and Compliance
/v1/tax-id/rulesCompliance: every country; Essentials and Pro: the countries of their pack only, and rules.scope is 'pack' (a check for another country should go to POST… - GETTax filing and payment deadlines due in a month. Essentials and Pro (countries of their pack) and Compliance
/v1/countries/:country/deadlines?year=2025&month=1Due dates are adjusted for weekends and public holidays where the country's rule (weekend_adjust) or the deadline's own rule is known; otherwise the statutory…
Webhooks
- GETList your webhooks (with the last delivery result). Developer, Essentials, Pro and Compliance
/v1/webhooksEvents go to keys on a plan with webhooks: each use of the key confirms its plan. Developer, Essentials and Pro (and the grandfathered Starter and Pro)… - POSTCreate a webhook (returns its secret once). Developer, Essentials and Pro (holidays), Compliance
/v1/webhooksAt most 3 webhooks per key (409 beyond). The body must be at most 4,000 bytes (413 beyond). The URL must be a public https address on the standard port,… - DELETEDelete a webhook (and its queued events). Developer, Essentials, Pro and Compliance
/v1/webhooks/:id - POSTSend a test event now. Developer, Essentials, Pro and Compliance
/v1/webhooks/:id/testDelivers a 'test' event immediately (one attempt; at most 5 tests per minute per key, then 429) and returns the HTTP status your URL answered, or the network… - GETChange log: every changed value with its old and new value and the reason. Developer, Essentials and Pro: holiday changes; Compliance: every change
/v1/changesOne entry per changed value, oldest first: old and new value, kind (law_change, correction, new_source, coverage), the date a law change applies from, the…
Private mode
- GETSigned country-year bundle, to compute holidays, business days, VAT on a date, deadlines and payroll rates on a date on your own machine. All plans (tax parts: Essentials and Pro for the countries of their pack, Compliance)
/v1/countries/:country/bundle?year=2025What the SDKs' private mode needs for one country and year: the year's holidays with their status (rule, confirmed, estimated, observed, bridge) in every…
Public
- GETFree public iCalendar feed of national holidays (no key)
https://africacompliancedata.com/calendar/:country.icsNational holidays for all supported years, one all-day event per holiday. Estimated (moon-sighted) dates are TENTATIVE and keep their UID, so subscribed…
API details
- Base URL
https://api.africacompliancedata.com- Authentication
- An API key in the x-api-key header
A bearer token in the Authorization header - Operations
- 31 operations on 28 pathsGET 26POST 4DELETE 1
1 marked deprecated - Main resources
- Tax data 13Holidays and business days 6Countries 5Webhooks 5Private mode 1Public 1
- Response formats
application/jsontext/calendartext/plain- Webhooks
- 1 described
- Description format
- OpenAPI 3.1.0, API version
1.0.0 - Links
- OpenAPI document · Terms of service · Support
How to test the Africa Compliance Data API in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the Africa Compliance Data API collection, without the publisher's secrets.
- Add your credentialsThis API uses an API key in the x-api-key header. Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “Your key: plan, status, monthly quota, country pack, rate limit and today's usage” (GET /v1/account), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the Africa Compliance Data API?
Every value cites its source: official texts first; secondary sources, press reports and estimates are labelled, with a confidence level. Every response… It is listed under Productivity & workspace and has 31 endpoints.
Who publishes the Africa Compliance Data API?
It is listed from Africacompliancedata's public API description (an OpenAPI document), not published by Africacompliancedata on Swastik Codes. Anyone who controls africacompliancedata.com can claim the profile by adding a DNS TXT record.
What is the base URL of the Africa Compliance Data API?
Requests go to https://api.africacompliancedata.com. Endpoint paths are added to this base URL.
How do I authenticate with the Africa Compliance Data API?
It accepts 2 methods: an API key in the x-api-key header; A bearer token in the Authorization header.
How many endpoints does the Africa Compliance Data API have?
31 operations on 28 paths (26 GET, 4 POST, 1 DELETE). The largest groups are Tax data, Holidays and business days, Countries, Webhooks.
Is forking the Africa Compliance Data API free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.