# list_dimensions

> Dimension catalog

**Call:** `GET /v1/dimensions`  
**Price:** Free  
**Available:** soft launch  
**Contract:** https://api.gwix.ai/docs/reference

## What it's for

The dimensions GWIX filters by (role, sub-job family, job family, SOC occupation, job level, company, industry, location), the parameter each feeds, ID formats and the lookup that returns IDs. Free and public.

## What comes back

`dimensions`, `meta`.

## When it doesn't work

| Status | What to do |
|---|---|
| 429 | Rate or concurrency limit. Wait `Retry-After` seconds. |

## Next steps

[`lookup`](/context/lookup)