Get Code Tables

GET/api/v1/codes

Fetch Kenya Revenue Authority code lookup tables used for item registration, sales, and stock operations. Optionally filter by code class.

Requires x-api-key

http://localhost:8100/api/v1/codes

Common Code Classes

GET {{API_PATH}}/codes/:cdCls | Single Code Class

Returns values for a specific code class. Replace :cdCls with a two-digit code class number (e.g. 04).

Response

{
  "resultCd": "000",
  "data": {
    "clsList": [
      {
        "cdCls": "04",
        "cdClsNm": "Tax Types",
        "dtlList": [
          { "cd": "A", "cdNm": "Tax Exempt", "cdDesc": "Exempt from VAT" },
          { "cd": "B", "cdNm": "16% VAT",    "cdDesc": "Standard VAT rate" }
        ]
      }
    ]
  }
}

# All code classes
curl http://localhost:8100/api/v1/codes \\
  -H "x-api-key: YOUR_API_KEY"

# Single code class
curl http://localhost:8100/api/v1/codes/04 \\
  -H "x-api-key: YOUR_API_KEY"