Last updated: 4 July 2026
KRA GavaConnect
LiveVerify KRA PINs, check Tax Compliance Certificates, and query taxpayer status instantly.
Who needs this: Any Kenyan business that works with suppliers, contractors, or needs tax compliance verification.
Example questions once connected
- Verify KRA PIN A001234567X
- Is supplier Juhudi Hardware Ltd TCC-compliant?
- Check all 50 suppliers in this list for expired TCCs
- What is the filing status for PIN P318295670X?
What you need before starting
- A KRA GavaConnect developer account at developer.go.ke
- Separate Consumer Key and Secret pairs for each KRA API product you want to use
⚠️
KRA requires a separate app per API product. You cannot use one set of credentials for all KRA tools. Msharti supports this automatically — just enter each credential set in the appropriate field.
Step-by-step setup
- Create a KRA developer account. Go to developer.go.ke, click Register, verify your email, and log in.
- Create one app per API product. Under My Apps → Create New App, create separate apps for: PIN Checker by PIN, PIN Checker by ID, TCC Checker, Import Certificate by PIN, Import Certificate by Number. Copy the Consumer Key and Secret from each.
- Connect in Msharti. Go to Connectors → KRA GavaConnect → Set Up. Paste the correct credentials into each section. Select Environment. Click Test Connection.
- Confirm success. Msharti tests each credential set separately. "Connected — 4 tools active" means all passed.
Tool reference
These are the tools the AI can call on this connector. Each tool fires automatically when you ask a relevant question.
check_tcc_status() Verify a Tax Compliance Certificate by KRA PIN and TCC serial number. Inputs kra_pin, tcc_serial (optional)
Try asking "Is TCC K92OR548W43A21N9 for PIN A948312567Q still valid?"
Returns Valid. Holder: Juhudi Hardware Ltd. Expiry: 14 Nov 2026. Status: Active.
validate_kra_pin() Confirm a KRA PIN is registered and return the taxpayer type and status. Inputs kra_pin
Try asking "Is KRA PIN P051234567X valid and active?"
Returns PIN P051234567X is valid. Type: Non-Individual. Status: Active. Registered: 12 Mar 2015.
filing_status() Check whether a taxpayer's returns are filed and up to date. Inputs kra_pin
Try asking "Are the tax filings for PIN A744610021G current?"
Returns All returns filed. Last return: VAT for April 2026, filed 15 May 2026. No outstanding obligations.
vat_lookup() Look up VAT registration status and effective date for a given KRA PIN. Inputs kra_pin
Try asking "Is supplier PIN P318295670X VAT-registered?"
Returns VAT registered. Effective: 1 Jan 2019. Status: Active. PIN: P318295670X.
Limits
- KRA requires a separate developer app per API product. Msharti handles this automatically — one setup flow, multiple credential sets stored securely.
- Token cache auto-refreshes every 5 minutes. Lookups during the brief refresh window (under 10 seconds) queue and retry automatically.
- Sandbox data does not reflect real taxpayer status — always switch to Production before releasing payment.
Sandbox test data
| Test value | Type | Expected result |
|---|---|---|
P318295670X | PIN Checker | Non-Individual, Active |
A744610021G | PIN Checker | Individual, Active |
A948312567Q / K92OR548W43A21N9 | TCC Checker | Valid TCC |
R10929K00A10050 | Import Certificate | Valid, Cosmetics |
Troubleshooting
| Problem | Cause | Fix |
|---|---|---|
| Invalid API call — no product match | Using credentials from one app to call a different API product | Create a separate app for each API product on developer.go.ke |
| Token expired | Cached token expired | Click Reconnect or wait 5 minutes — Msharti auto-refreshes |
Need help? [email protected] — Nairobi-based, same time zone.