Tax Optimization Suggestions

Get intelligent, AI-powered suggestions to reduce tax liability through compliant relief maximization and strategic planning. All recommendations are fully compliant with Nigerian tax laws.

Smart Suggestions

AI-powered recommendations based on your income profile

100% Compliant

All suggestions comply with Nigerian tax regulations

Maximize Savings

Identify missed deductions and relief opportunities

HTTP Request

POSThttps://pioe.app/api/v1/tax/optimize

Request Body Parameters

Parameter	Type	Required	Description
taxYear	number	Yes	Tax year for optimization (e.g., 2024)
incomeStreams	array	Yes	Array of income sources with type, amount, frequency
pensionContribution	number	No	Current annual pension contributions
nhf	number	No	National Housing Fund contributions
lifeAssurance	number	No	Life insurance premium payments

Code Examples

const response = await fetch("https://pioe.app/api/v1/tax/optimize", {
  method: "POST",
  headers: {
    "X-API-Key": "your_api_key_here",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    taxYear: 2024,
    incomeStreams: [
      { type: "salary", amount: 1000000, frequency: "monthly" }
    ],
    pensionContribution: 50000,
    nhf: 0,
    lifeAssurance: 0
  })
});

const data = await response.json();
console.log("Potential Savings:", data.potentialSavings);
console.log("Suggestions:", data.suggestions);

Success Response

200 OKSuccess response

{
  "currentTaxLiability": 2640000,
  "optimizedTaxLiability": 2340000,
  "potentialSavings": 300000,
  "savingsPercentage": 11.36,
  "suggestions": [
    {
      "category": "pension",
      "title": "Increase Pension Contributions",
      "description": "Maximize your pension contributions to 8% of gross income for additional ₦200,000 relief",
      "potentialSaving": 200000,
      "actionRequired": "Increase monthly pension from ₦50,000 to ₦80,000"
    },
    {
      "category": "nhf",
      "title": "National Housing Fund Contribution",
      "description": "Contribute 2.5% of basic salary to NHF for ₦100,000 relief",
      "potentialSaving": 100000,
      "actionRequired": "Enroll in NHF scheme through your employer"
    }
  ],
  "complianceNotes": [
    "All suggestions comply with Finance Act 2023",
    "Pension relief capped at 20% of gross income",
    "NHF contributions are tax-deductible"
  ]
}

Try it Live

Use our interactive playground to test requests in real-time.

Open Playground