List Occupations

View as Markdown
Returns ISCO-08 occupation codes and/or legacy OCC1–OCC11 codes for use in `registerCustomer` / `updateCustomer` `occupation`. **Authentication:** - **REQUIRED**: Basic Auth only. **Query Parameters:** - `format` (optional): `isco` (default), `legacy`, or `all`. - `level` (optional): Integer 1–4. Filters ISCO entries by hierarchy level. Ignored when `format=legacy`. **Response (`format=isco`):** - `occupations`: Array of `{ code, level, title, legacy_occ }` - `format`, `count`, and `level` (when provided) **Response (`format=legacy`):** - `occupations`: Array of `{ code, title, isco_code }` - `format`, `count` **Response (`format=all`):** - `isco` and `legacy` arrays, plus `count` object and optional `level` **Notes:** - Prefer ISCO-08 codes for new integrations. Legacy OCC1–OCC11 remain accepted for backward compatibility. - Use returned `code` values as the `occupation` field on customer APIs.

Authentication

AuthorizationBasic

Basic Auth: base64(client_id:client_secret)

Query parameters

formatenumOptionalDefaults to isco

Optional: isco (default), legacy, or all

Allowed values:
levelintegerOptional1-4

Optional: Filter ISCO entries by hierarchy level (1–4). Ignored for format=legacy.

Response

OK
occupationslist of maps from strings to any
formatenum
countinteger
levelintegerOptional

Errors

400
Bad Request Error
401
Unauthorized Error