Register a Service Item

POST/api/v1/items/service

Register a service item with Kenya Revenue Authority using a simplified interface. The API automatically sets item classification to SV (Service) and fills default values. Use this for software, subscriptions, consulting, and other non-physical services.

Requires x-api-key

http://localhost:8100/api/v1/items/service

Auto-Generated Item Code Format

Item Code Pattern

Headers

Field	Type	Required	Description
x-api-key	string	Required	Your Ushuru API key
Content-Type	string	Required	Must be application/json

Request Body

Field	Type	Required	Description
itemName	string	Required	Display name of the service item (max 100 chars)
taxType	string	Required	Tax type code: A=Exempt, B=16% VAT, C=0% VAT, D=Non-VAT
price	number	Optional	Default unit price in KES (inclusive of VAT). Optional, can be set per-transaction.
itemCode	string	Optional	Custom item code. Auto-generated if omitted.
description	string	Optional	Internal description for your records.
useYn	string	Optional	Active flag: Y=Active, N=Inactive. Defaults to Y.

Request

{
  "itemName": "Monthly SaaS Subscription",
  "taxType": "B",
  "price": 5000,
  "description": "Per-seat monthly subscription fee"
}

Response

{
  "resultCd": "000",
  "resultMsg": "Item registered successfully",
  "data": {
    "itemCd": "SV0000000Z001",
    "itemNm": "Monthly SaaS Subscription",
    "itemClsCd": "SV",
    "taxTyCd": "B",
    "useYn": "Y",
    "regDt": "20240115",
    "modiDt": "20240115"
  }
}

curl -X POST http://localhost:8100/api/v1/items/service \\
  -H "x-api-key: YOUR_API_KEY" \\
  -H "Content-Type: application/json" \\
  -d '{
    "itemName": "Monthly SaaS Subscription",
    "taxType": "B",
    "price": 5000
  }'