Calculate Tax
Leverage our proprietary tax engine to perform highly accurate Nigerian Personal Income Tax (PIT) calculations with year-based rule selection (legacy pre-2026 and post-2026 reform regimes).
Year-Aware Compliance
This endpoint applies rules by tax year: CRA-based legacy logic for years up to 2025, and post-2026 reform logic for 2026 onward. Response includes the applied tax regime marker.
HTTP Request
POSThttps://pioe.app/api/v1/tax/calculate
Request Parameters
| Parameter | Type | Description |
|---|---|---|
| taxYear | number | The year used to select PIT regime (legacy pre-2026 vs post-2026 reform). |
| state | string | Nigerian state for specialized levies (e.g., "Lagos"). |
| incomeStreams | array | List of income sources (salary, business, etc.) with frequency. |
| pensionContribution | number | Statutory pension deduction (tax-exempt). |
Usage Examples
const response = await fetch("https://pioe.app/api/v1/tax/calculate", {
method: "POST",
headers: {
"X-API-Key": "your_api_key_here",
"Content-Type": "application/json"
},
body: JSON.stringify({
taxYear: 2025,
state: "Lagos",
incomeStreams: [
{
type: "salary",
amount: 500000,
frequency: "monthly"
}
],
pensionContribution: 40000,
nhf: 12500
})
});
const data = await response.json();
console.log(data.taxDue);Success Response
200 OK
{
"calculationId": "k17abc123def456...",
"totalIncome": 6000000,
"taxableIncome": 5480000,
"taxDue": 860400,
"effectiveRate": 0.1434,
"taxRegimeVersion": "post_2026_nigeria_tax_reform",
"reliefsApplied": ["pension", "nhf", "nhis"],
"exempt": false,
"message": "Calculation successful. Use calculationId for filing."
}Try it Live
Use our interactive playground to test requests in real-time.
Calculate CIT
Perform complex Corporate Income Tax (CIT) and Education Tax (EDT) calculations for Nigerian companies.
HTTP Request
POSThttps://pioe.app/api/v1/tax/calculate-cit
Request Parameters
| Parameter | Type | Description |
|---|---|---|
| companyName | string | Full registered company name. |
| rcNumber | string | CAC Registration Number. |
| turnover | number | Total annual revenue/turnover. |
| assessableProfit | number | Profit after allowable expenses but before tax. |
CIT Usage Example
const response = await fetch("https://pioe.app/api/v1/tax/calculate-cit", {
method: "POST",
headers: {
"X-API-Key": "your_api_key_here",
"Content-Type": "application/json"
},
body: JSON.stringify({
taxYear: 2025,
companyName: "Acme Corp Ltd",
rcNumber: "RC123456",
tin: "12345678-0001",
turnover: 50000000,
assessableProfit: 15000000,
citLiability: 4500000,
edtLiability: 450000
})
});
const data = await response.json();
console.log("CIT Due:", data.citLiability);Success Response
200 OK
{
"calculationId": "k17cit789xyz...",
"taxYear": 2025,
"companySize": "medium",
"turnover": 50000000,
"assessableProfit": 15000000,
"citLiability": 4500000,
"edtLiability": 375000,
"totalTaxDue": 4875000,
"effectiveCitRate": 30,
"breakdown": {
"citRate": 30,
"edtRate": 2.5,
"capitalAllowances": 0
},
"message": "CIT calculation successful. Use calculationId for filing."
}Try it Live
Use our interactive playground to test requests in real-time.