Reference Data
Countries, currencies, categories, and subcategories — static lookup data for the platform
Reference data endpoints return static lookup tables used across the API. These change infrequently and are cached for 1 day with a 10-minute stale-while-revalidate window.
All endpoints require authentication via JWT Bearer token.
Endpoints
GET /api/v1/countries → All countries (ISO 3166)
GET /api/v1/countries/:id → Single country by ID
GET /api/v1/currencies → All currencies (ISO 4217)
GET /api/v1/categories → Product categories (vouchers feature)
GET /api/v1/categories/:id → Single category by ID
GET /api/v1/subcategories → Product subcategories (vouchers feature)
GET /api/v1/subcategories/:id → Single subcategory by IDFeature Gating
Categories and subcategories require the vouchers feature to be enabled for your client. If not enabled, these endpoints return 400 INVALID_FEATURE.
Countries and currencies are available to all authenticated clients.