People
tier:standard

Get an occupation

Returns one SOC 2018 or ISCO-08 occupation with its parent, its children, and the same occupation in the other standard per the official BLS crosswalk. The {code} parameter accepts the code, slug, or title.

get/v1/people/occupations/{code}

Request

  • Base URL: https://api.particle.pro
  • URL: https://api.particle.pro/v1/people/occupations/{code}
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Path parameters

codestring required

The occupation's SOC 2018 or ISCO-08 code (29-1212, 2212), slug (cardiologists), or title (Cardiologists). A title both standards share resolves to the SOC occupation; the ISCO group is among its equivalents.

Response

OK

codestring required

The standard's own notation, such as 29-1212 (SOC), 2212 (ISCO), or 320101 (FoR).

group'minor' | 'broad' | 'alias'

Set for a code that stands for several detailed SOC 2018 occupations: a SOC minor group (such as 29-1000 Healthcare Diagnosing or Treating Practitioners), a broad group (such as 29-1210 Physicians), or an alias, an everyday name such as doctors (physicians and surgeons). Every occupation filter accepts one and matches a speaker listed under any of its occupations.

levelinteger

Depth in the standard's official hierarchy: SOC major group 1 and detailed occupation 2; FoR division 1, group 2, field 3; ISCO-08 unit group 4 and minor group 3. ISCO-08 codes are the groups SOC maps to, listed flat without the standard's upper levels. Omitted for a SOC group or alias (see group).

parent_codestring

The standard's official parent code; omitted at the top level and for every ISCO-08 code, since ISCO-08 is listed without its upper levels. A SOC broad group's parent is its minor group and a minor group's its major group, but a detailed SOC occupation's official parent is its major group (29-1211 has parent_code 29-0000), so it can differ from parent, which is the browse parent one level up (29-1210).

slugstring required

The title as a URL segment, such as cardiologists.

standard'soc_2018' | 'isco_08' | 'anzsrc_for_2020' required

The standard the code belongs to: soc_2018 (US Standard Occupational Classification), isco_08 (the ILO's International Standard Classification of Occupations), or anzsrc_for_2020 (ANZSRC Fields of Research).

titlestring required

The standard's official title, such as Cardiologists.

Changes

No recorded changes to this operation across all 2 revisions of this API.