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:

• POST /customers when creating an individual customer.
• PUT /customers/{id}/kyc/profile when editing one.

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

Example

curl "$SEISMIC_ORCHESTRATION_URL/v0/soc-codes"

See also

• Occupation codes: the full catalog, grouped for browsing.
• Customers: the employment block carrying occupation_soc.
• GET /industries: the NAICS industry catalog, for businesses.