Tax Filings

Automate the submission of tax returns and track their processing status directly within your application.

Instant Payment

Filings are paid instantly using your developer wallet balance.

Automated Compliance

Receipts and confirmation documents are generated automatically.

Submit PIT Filing

POSThttps://pioe.app/api/v1/tax/file-pit

Submit a Personal Income Tax return. This endpoint requires a calculationId from a previous calculation.

PIT Usage Example

const response = await fetch("https://pioe.app/api/v1/tax/file-pit", {
  method: "POST",
  headers: {
    "X-API-Key": "your_api_key_here",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    calculationId: "calc_123...",
    firstName: "Joshua",
    lastName: "Example",
    taxYear: 2025,
    incomeStreams: [
      { type: "salary", amount: 500000, frequency: "monthly" }
    ]
  })
});

const data = await response.json();
console.log("Filing ID:", data.data.filingId);

Try it Live

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

Open Playground

Submit CIT Filing

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

CIT Usage Example

const response = await fetch("https://pioe.app/api/v1/tax/file-cit", {
  method: "POST",
  headers: {
    "X-API-Key": "your_api_key_here",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    calculationId: "k17cit456...",
    companyName: "Acme Corp Ltd",
    rcNumber: "RC123456",
    tin: "12345678-0001",
    taxYear: 2025,
    turnover: 50000000,
    assessableProfit: 15000000,
    citLiability: 4500000,
    edtLiability: 450000,
    cgtLiability: 300000,
    capitalIncomeBreakdown: { dividends: 1000000, interest: 250000 },
    disposalSchedule: [
      { assetClass: "shares", proceeds: 4000000, costBase: 3000000, disposalDate: "2025-11-30" }
    ]
  })
});

const data = await response.json();
console.log("Filing ID:", data.data.filingId);

CIT filing responses may include rolloutMode and reconciliation metadata during phased rollout of capital-income tax controls.

Try it Live

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

Open Playground

Check Filing Status

Retrieve the real-time status and generated documents for a specific tax filing.

HTTP Request

GEThttps://pioe.app/api/v1/tax/filing-status?filingId=FILING_ID&type=pit|cit

Status Usage Example

const filingId = "fil_123...";
const response = await fetch(`https://pioe.app/api/v1/tax/filing-status?filingId=${filingId}&type=pit`, {
  headers: {
    "X-API-Key": "your_api_key_here"
  }
});

const result = await response.json();
console.log("Current Status:", result.data.status);
if (result.data.proofUrl) {
    console.log("Receipt URL:", result.data.proofUrl);
}

Try it Live

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

Open Playground