Corporate & Compliance

Suite of tools for business entity verification (KYB) and corporate tax liability assessment.

1Calculate CIT

Calculate Company Income Tax (CIT) and Education Tax (EDT) based on turnover and profitability. Includes canonical capital-income computation (dividends, interest, rent, royalties, and disposal schedule) with corporate CGT routing in the response.

POSThttps://pioe.app/api/v1/tax/calculate-cit

Parameter	Type	Description
turnover	number	Gross revenue for the period.
taxYear	number	e.g., 2025
operatingExpenses	number	(Optional) Total OPEX.
applyEducationTax	boolean	Whether to calculate EDT. Default true.
capitalIncomeBreakdown	object	Optional detailed heads: dividends, interest, rent, royalties, otherInvestmentIncome.
disposalSchedule	array	Optional disposal entries for corporate CGT (assetClass, proceeds, costBase, disposalDate).
withholdingCredits / foreignTaxCredits	number	Optional credits applied against total tax liability.

const response = await fetch("https://pioe.app/api/v1/tax/calculate-cit", {
  method: "POST",
  headers: { "X-API-Key": "YOUR_KEY" },
  body: JSON.stringify({
    taxYear: 2025,
    turnover: 50000000,
    costOfSales: 20000000,
    operatingExpenses: 5000000,
    capitalIncomeBreakdown: {
      dividends: 1500000,
      interest: 500000
    },
    disposalSchedule: [
      { assetClass: "shares", proceeds: 4000000, costBase: 2500000, disposalDate: "2025-12-01" }
    ]
  })
});
console.log(await response.json());

Success Response

200 OK

{
  "calculationId": "k17cit456...",
  "taxYear": 2025,
  "entityTaxPath": "corporate_cit",
  "companySize": "medium",
  "financials": {"turnover": 50000000, "assessableProfit": 26500000, "totalProfit": 23500000},
  "taxLiability": {"cit": 4700000, "educationTax": 1060000, "cgt": 450000, "total": 6210000},
  "capitalIncomeComputation": {"grossAmount": 3000000, "taxableAmount": 3000000, "liabilityAfterCredits": 900000},
  "taxAuthorityRouting": [{"component":"capital_gains","taxType":"CGT_CORPORATE","authority":"NRS"}],
  "rolloutMode": "shadow",
  "reconciliation": {"varianceAmount": 450000, "variancePercent": 6.85, "withinThreshold": false},
  "message": "CIT calculation successful"
}

Try it Live

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

Open Playground

2Verify Company

Check if a business is registered with the Corporate Affairs Commission (CAC).

GEThttps://pioe.app/api/v1/verify/company

// GET /api/v1/verify/company?rcNumber=RC123456

{
  "isValid": true,
  "companyName": "MOCK TECH INDUSTRIES LTD",
  "rcNumber": "RC123456",
  "status": "ACTIVE",
  "incorporationDate": "2015-05-12"
}

SDK Support

Official libraries for Node.js and Python available on GitHub.

Data Freshness

All verification data is synced directly from CAC every 24 hours.

State & Metadata

Need specific tax codes? Use the metadata endpoint.

GET /api/v1/metadata/states

Try it Live

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

Open Playground