eTIMS code lists

KRA code lists cached for the organization.

GEThttps://api.tracksales.co/api/v1/etims/code-lists

Required scope: etims:read

Query Params

typestring

Filter by list type (e.g. item_cls_cd, pkg_unit_cd)

Responses

200OK

Request succeeded.

401Unauthorized

API key is missing or invalid.

403Forbidden

API key lacks the required scope.

404Not Found

Etims was not found.

422Validation Error

Request validation failed.

curl -X GET 'https://api.tracksales.co/api/v1/etims/code-lists' \
  -H 'Authorization: Bearer ts_live_YOUR_API_KEY' \
  -H 'Accept: application/json'

{
    "success": true,
    "data": [
        {
            "list_type": "item_cls_cd",
            "code": "50102517",
            "name": "General goods"
        }
    ]
}

{
    "success": false,
    "error": {
        "code": "unauthenticated",
        "message": "Invalid or revoked API key."
    }
}

{
    "success": false,
    "error": {
        "code": "forbidden",
        "message": "API key lacks required scope."
    }
}

{
    "success": false,
    "message": "Etims not found"
}

{
    "success": false,
    "message": "Validation failed",
    "errors": {
        "field": [
            "The field is required."
        ]
    }
}