Quickstart
Make your first request to the Tax Nigeria Partner API in under 5 minutes.
Quickstart Guide
Integrate Nigeria's official tax intelligence engine into your application in under 5 minutes.
Obtain Your API Key
- Log into your Tax Nigeria Workspace.
- Open Settings from the bottom-left sidebar menu.
- Select the Developer tab.
- Click Create New Key, give it a descriptive name (e.g.,
Payroll Integration - Prod), select the required scopes (such astax:calculate), and copy your API key secret immediately.
API keys begin with the prefix txn_. Store your secret key securely in an environment variable (TAX_NIGERIA_API_KEY).
Make Your First Calculation Request
Compute personal income tax (PAYE) for an employee earning ₦8,500,000 annually with statutory deductions (Pension, NHF, NHIS):
curl -X POST "https://taxnigeria.ng/api/v1/tax/paye" \
-H "Authorization: Bearer txn_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"annualGrossSalary": 8500000,
"pensionContribution": 680000,
"nhfContribution": 212500,
"nhisContribution": 425000,
"lifeAssurance": 0
}'Inspect the Response
The API returns a typed response with exact tax breakdowns, Consolidated Relief Allowance (CRA), statutory deductions, and human-friendly spoken summaries:
{
"annualGrossSalary": 8500000,
"consolidatedReliefAllowance": 1900000,
"statutoryDeductions": {
"pension": 680000,
"nhf": 212500,
"nhis": 425000,
"lifeAssurance": 0,
"total": 1317500
},
"taxableIncome": 5282500,
"annualTax": 1056500,
"monthlyTax": 88041.67,
"effectiveTaxRate": 12.43,
"taxBands": [
{ "band": "First ₦300,000", "rate": 7, "taxableAmount": 300000, "taxDue": 21000 },
{ "band": "Next ₦300,000", "rate": 11, "taxableAmount": 300000, "taxDue": 33000 },
{ "band": "Next ₦500,000", "rate": 15, "taxableAmount": 500000, "taxDue": 75000 },
{ "band": "Next ₦500,000", "rate": 19, "taxableAmount": 500000, "taxDue": 95000 },
{ "band": "Next ₦1,600,000", "rate": 21, "taxableAmount": 1600000, "taxDue": 336000 },
{ "band": "Above ₦3,200,000", "rate": 24, "taxableAmount": 2082500, "taxDue": 496500 }
],
"spokenSummary": "For an annual gross salary of ₦8,500,000, the total annual PAYE liability is ₦1,056,500, resulting in a monthly deduction of approximately ₦88,041.67. Effective tax rate is 12.43%."
}Next Steps
- Explore Authentication & Scopes to manage permissions and rate limits.
- Review 2026 Nigerian Tax Act Updates to see exemption rules and statutory thresholds.
- Browse the API Reference for CIT, WHT, Penalties, AI Query, and Chat endpoints.