Integrate Nigeria's most comprehensive tax calculation API into your applications. Free, fast, and compliant with 2025/2026 Tax Act.
NOTA (Nigeria Open Tax API) provides a RESTful API for calculating all major Nigerian taxes based on the 2025/2026 Tax Act. Our API is designed to be simple, reliable, and developer-friendly.
https://hmwcdpm2zoz3qxqbsknzm6k5ie0arpgb.lambda-url.eu-north-1.on.awsRate limiting applies to ensure fair usage and service availability for all users. Please implement appropriate caching and request throttling in your applications.
/tax/pit/calculateCalculate Personal Income Tax based on annual taxable income and taxpayer profile.
/tax/cit/calculateCalculate Company Income Tax and Development Levy for businesses.
/tax/vat/calculateCalculate VAT payable and check registration requirements.
/tax/wht/calculateCalculate Withholding Tax for various transaction types.
/tax/cgt/calculateCalculate Capital Gains Tax with exemption checks.
/tax/taxable-incomeCalculate taxable income from gross income with deductions.
// JavaScript/TypeScript Example
const response = await fetch(
'https://hmwcdpm2zoz3qxqbsknzm6k5ie0arpgb.lambda-url.eu-north-1.on.aws/tax/pit/calculate',
{
method: 'POST',
headers: {
'Content-Type': 'application/json',
},
body: JSON.stringify({
email: 'user@example.com',
annual_taxable_income: 5000000,
taxpayer_profile: {
employment_status: 'employed',
has_paye_employer: true,
employer_tin: null
},
state_of_residence: 'Lagos'
})
}
);
const data = await response.json();
console.log(data);{
"email": "user@example.com",
"annual_taxable_income": 5000000,
"pit_breakdown": [
{
"band": "First ₦800,000",
"rate": 0,
"taxable_amount": 800000,
"tax_due": 0
},
{
"band": "Next ₦800,000",
"rate": 0.07,
"taxable_amount": 800000,
"tax_due": 56000
}
// ... more bands
],
"total_pit_due": 625000,
"routing": {
"route_type": "PAYE",
"remitting_authority": "state",
"state": "Lagos"
},
"annual_return_required": true,
"legal_basis": "Nigeria Tax Act 2025..."
}We're here to support developers building with NOTA. Access our full documentation or reach out for assistance.