Skip to navigation
SQRIL SaaS APIPayout Endpoints

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
Allowed values:
countinteger
levelintegerOptional

Errors

400
Bad Request Error
401
Unauthorized Error