List Occupations
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
format
Optional: isco (default), legacy, or all
Allowed values:
level
Optional: Filter ISCO entries by hierarchy level (1–4). Ignored for format=legacy.
Response
OK
occupations
format
count
level
Errors
400
Bad Request Error
401
Unauthorized Error

