Reference Data

Countries, currencies, categories, and subcategories - static lookup data used across the API

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 ID

Countries and currencies are available to all authenticated clients.

Endpoints

On this page