Getting Started with iSale API

iSale is a comprehensive solution that bridges the gap between your business operations and KRA's eTIMS system. Our API provides seamless integration capabilities for tax compliance and management.

Base URL

Requirements

• Valid API key from iSale
• KRA PIN number
• Active internet connection
• SSL certificate for secure communications

Rate Limiting

Our API implements rate limiting to ensure fair usage:

• Basic tier: 100 requests per minute
• Professional tier: 1000 requests per minute
• Enterprise tier: Custom limits

Authentication

All API requests require authentication using Bearer tokens. You'll need to include your API key in the Authorization header:

API Key Generation

To obtain your API key:

1. Log in to your iSale dashboard
2. Navigate to Settings → API Keys
3. Click "Generate New Key"
4. Store your key securely - it won't be shown again

API Endpoints

Error Handling

The API uses conventional HTTP response codes to indicate success or failure of requests:

{
  "error": {
    "code": "ERROR_CODE",
    "message": "Human readable message",
    "details": { }
  }
}