People
tier:standard

List occupations

Lists one level of an official occupation standard: SOC 2018 major groups, or the detailed occupations under one; or, for ISCO-08, the groups SOC 2018 maps to, listed flat: 436 unit groups and the two minor groups (211, 315) the crosswalk maps an occupation to whole. Every code, slug, and title listed here is accepted wherever speaker expertise is filtered by occupation.

get/v1/people/occupations

Request

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

Query parameters

limitinteger

Results per page (default: all)

cursorstring

Opaque pagination cursor from previous response

standard'soc_2018' | 'isco_08'

Occupation standard to browse: soc_2018 (US Standard Occupational Classification; major groups, then minor groups, broad groups and detailed occupations) or isco_08 (ILO International Standard Classification of Occupations; the groups SOC 2018 maps to, listed flat: unit groups, plus the minor groups 211 and 315).

parentstring

List the occupations one level below this one. Accepts its code (11-0000), slug (management-occupations), or title (Management Occupations). Omit to list the top level.

qstring

Search the standard's occupations by title instead of listing a level: words match in either number and by prefix, so cardiologist finds Cardiologists. With parent, only occupations below that one are searched. Best matches first.

Response

OK

cursorstring

Pass to next request for more results

has_moreboolean required

Whether more results exist

Changes

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