Turn KRA iTax into an API

What you can build on KRA iTax

• Check a Tax Compliance Certificate

  Build this

  Looks up a TCC number in the TCC/Exemption/Excise License Checker on iTax and reads whether the certificate is valid and whose it is.

  Takes

  TCC number

  Returns

  TCC number, KRA PIN, taxpayer name, status, issue date, expiry date

• Verify a supplier's KRA PIN

  Build this

  Looks up a KRA PIN in the PIN Checker on iTax and reads the taxpayer it is registered to.

  Takes

  KRA PIN

  Returns

  KRA PIN, taxpayer name, PIN status

• Generate a payment registration slip

  Build this

  Fills in Payment Registration under the Payments tab for one tax head, subhead and tax period, and returns the Payment Registration Number.

  Takes

  Tax head, tax subhead, tax period, liability, mode of payment

  Returns

  Payment Registration Number, tax head, tax subhead, tax period, amount

• Apply for a Tax Compliance Certificate

  Build this

  Submits the TCC application under the Certificates menu for your PIN and reads the acknowledgement or the reason it was refused.

  Takes

  Nothing

  Returns

  Acknowledgement number, outcome, message

Automate KRA iTax with a workflow

A workflow runs your methods as one process, with nobody at the screen. A schedule or a call from your own system starts it, the steps run in order, and the result arrives in your inbox or in the systems you already use.

• Suppliers' Tax Compliance Certificates, checked weekly

  Build this

  Starts

  Every Monday at 7:00, East Africa Time

  Step 1

  For each supplier TCC number you list, check the certificate in the TCC Checker.

  Step 2

  Keep the certificates that are not valid, or that expire in the next 30 days.

  Step 3

  Email you the list with supplier, KRA PIN, TCC number and expiry date.

• New suppliers' PINs, verified before onboarding

  Build this

  Starts

  When your system calls the workflow's webhook with a new supplier's KRA PIN

  Step 1

  Verify the KRA PIN in the PIN Checker.

  Step 2

  Compare the taxpayer name iTax returns with the name your system sent.

  Step 3

  Post the PIN, both names and whether they match to your ERP's webhook.

• PAYE payment slip after the return is filed

  Build this

  Starts

  When your payroll system calls the webhook with the tax period and the PAYE due

  Step 1

  Generate a payment registration slip for Income Tax- PAYE for that tax period.

  Step 2

  Post the Payment Registration Number and amount to your accounting system's webhook.

  Step 3

  Email you the same, so the PAYE is paid by the 9th of the following month.

You can run a workflow by hand on every plan, Free included. Schedules and webhook triggers come with the paid plans, from $29 a month.

Once built, one call from your code

Once you have built a method, it is one POST to /v1/runs from your backend, or a tool an AI agent calls over MCP. This is what “Check a Tax Compliance Certificate” would look like.

curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "itax.kra.go.ke/check_tax_compliance_certificate",
    "input": {
      "tcc_number": "KRAZZ1234567890"
    }
  }'

{
  "status": "completed",
  "data": {
    "tcc_number": "KRAZZ1234567890",
    "kra_pin": "P000000001A",
    "taxpayer_name": "Northwind Logistics Limited",
    "status": "Valid",
    "issue_date": "2026-03-02",
    "expiry_date": "2027-03-01"
  }
}

An example with invented data, not a ready-made endpoint. The method exists in your organization once you build it, and its name, inputs and fields follow your request.

KRA iTax’s own options

KRA runs GavaConnect, an API platform with more than 16 APIs, among them Nil Filing and checkers for PINs and Tax Compliance Certificates. Access is free for approved developers and businesses after registration. Returns, payment slips and certificate applications are otherwise done on iTax, with Excel return forms uploaded under Returns.

Read on November 12, 2026: KRA facts: GavaConnect, KRA: Pay As You Earn (PAYE), iTax enhancements, September and October 2025.

Signing in to KRA iTax

iTax signs you in with your KRA PIN or ID number and your password, with a Forgot Password link on the same page. With Fous you sign in once through iTax's own sign-in with your own account: the login is sealed with AES-256, never returned by the API or written to logs, and an expired session is signed back in.

Worth knowing

Returns are Excel forms uploaded as a zip

You download the return form, click VALIDATE, and iTax's template creates a zipped file that you upload under Returns, File Return. An acknowledgement receipt confirms the filing.

Simplified PAYE return since 1 September 2025

Employers must use the simplified PAYE return template for tax periods from 01/09/2025. iTax rejects the old template with an error telling you to use the new one.

A TCC is issued at once, or refused

With no outstanding liabilities, the certificate goes straight to your registered email. Since late 2025 iTax also checks eTIMS registration and the VAT Special Table for business PINs. A TCC is valid for 12 months.

Due dates differ by tax

PAYE is filed and paid by the 9th of the following month, VAT by the 20th, and withholding tax within 5 working days of the deduction. A copy of each PAYE or VAT payment slip goes to your registered email.

More in Government: Middle East and Africa

• CAC Company Registration Portal
• CIPC eServices
• GDRFA Dubai Smart Services
• eTIMS
• Rev360
• Qiwa
• ICP Smart Services
• SARS eFiling
• SIMPL
• Egyptian Tax Authority e-Services
• ZATCA e-Services
• uFiling
• EmaraTax
• Mudad

Other industries: e-Zamówienia, ePortal ESTV, The Compliance Engine, ApplyOnline, E-Verify, COMMBUYS.