Regions & categories

Regions and categories are read-only catalogs used to build filters on Forecasts, Drivers, and Alerts. For regions, use the id field in filters.regions[]; for categories, use the id field in filters.categories[].

Regions represent geographic dimensions: countries, sub-regions, or broader economic zones. Each entry carries an id (used in filters.regions[]), a name, and geographic coordinates.

Categories represent thematic or sector dimensions: industry groups, commodity classes, or similar classifications. Each entry carries an id (used in filters.categories[]) and a name.

Both lists are returned in full with no pagination, sorted by id in ascending order.

Pricing

Authentication is required but these catalogs are not billed. Lookups do not consume credits.

See also

• API reference with code examples: GET /api/v1/regions · GET /api/v1/categories.
• These ids are used in filters on: Forecasts · Drivers · Alerts.
• Clients: Using curl · Python SDK · Go SDK · Java SDK.