Developer API

Build with TaxHub API

Integrate KRA verification into your applications with our simple, powerful REST API. Same credit pricing, full programmatic access.

Get API KeyView Endpoints
curl -X POST https://api.taxhub.co.ke/v1/verify/pin \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"KRAPIN": "A123456789"}'

Fast Response

Average response time under 500ms

Secure

TLS 1.3 encryption, API key authentication

JSON API

Clean RESTful API with JSON responses

Well Documented

Comprehensive docs with examples

Authentication

All API requests require authentication using a Bearer token. Include your API key in the Authorization header:

Authorization: Bearer txh_your_api_key_here

You can generate API keys from your dashboard. Each API key is tied to your account and uses credits from your balance.

API Endpoints

POST/v1/verify/pin1 credit

Verify a KRA PIN

POST/v1/verify/pin-by-id1 credit

Look up PIN by National ID

POST/v1/verify/tcc3 credits

Verify Tax Compliance Certificate

POST/v1/verify/obligations2 credits

Get taxpayer obligations

POST/v1/verify/it-exemption2 credits

Check IT exemption status

POST/v1/verify/vat-exemption2 credits

Check VAT exemption status

POST/v1/verify/excise-license2 credits

Verify excise license

Response Format

Success Response

{
  "success": true,
  "data": {
    "ResponseCode": "000",
    "Message": "Success",
    "Status": "Active",
    "PINDATA": {
      "KRAPIN": "A123456789",
      "TypeOfTaxpayer": "Individual",
      "Name": "JOHN DOE",
      "StatusOfPIN": "Active"
    }
  },
  "responseTime": 234,
  "creditsUsed": 1
}

Error Response

{
  "success": false,
  "error": "Invalid KRA PIN format",
  "responseTime": 12
}

Rate Limits

PlanRate LimitBurst
Free / Starter10 requests/minute20 requests
Professional60 requests/minute100 requests
Business300 requests/minute500 requests
EnterpriseUnlimitedCustom

Start Building Today

Get your API key and 5 free credits to start integrating.

Get Your API Key