Skip to content
Seismic Orchestration

GET /soc-codes

The SOC occupation catalog: every code accepted by the KYC employment.occupation_soc field, each with its official title. Fetch it once and drive your occupation picker from it.

Unauthenticated. No Api-Key or Authorization header required.

Browsing rather than integrating? Occupation codes lists all 867 accepted codes grouped by major group, for picking one by hand.

Where occupation codes are used

occupation_soc sits on the employment block of an individual's KYC profile:

It is required at submit and it is the only way to state an occupation: there is no free-text alternative, and a code outside this catalog is rejected. Pick the entry that best describes the customer's job — every one of the 867 codes is accepted, so there is always something closer than a guess.

Response 200

A bare array, sorted ascending by code, 867 entries in total (truncated here — the full catalog is browsable):

[
  {
    "code": "11-1011",
    "description": "Chief Executives"
  },
  {
    "code": "15-1252",
    "description": "Software Developers"
  },
  {
    "code": "53-7121",
    "description": "Tank Car, Truck, and Ship Loaders"
  }
]

SocCode

FieldTypeNotes
codestringSix-digit SOC code in NN-NNNN form. Pass this as occupation_soc.
descriptionstringOfficial occupation title: what your picker should display.

Example

curl "$SEISMIC_ORCHESTRATION_URL/v0/soc-codes"

See also