curl -H "X-API-Key: $PARTICLE_API_KEY" \
"https://api.particle.pro/v1/people/occupations?standard=soc_2018"{
"data": [
{
"code": "<string>",
"level": 123,
"slug": "<string>",
"standard": "soc_2018",
"title": "<string>",
"parent_code": "<string>"
}
],
"has_more": true,
"cursor": "<string>"
}{
"detail": "Property foo is required but is missing.",
"error_code": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"resolve": {
"message": "<string>",
"action": "<string>",
"endpoint": "<string>",
"method": "<string>",
"url": "<string>"
},
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}{
"detail": "Property foo is required but is missing.",
"error_code": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"resolve": {
"message": "<string>",
"action": "<string>",
"endpoint": "<string>",
"method": "<string>",
"url": "<string>"
},
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}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.
curl -H "X-API-Key: $PARTICLE_API_KEY" \
"https://api.particle.pro/v1/people/occupations?standard=soc_2018"{
"data": [
{
"code": "<string>",
"level": 123,
"slug": "<string>",
"standard": "soc_2018",
"title": "<string>",
"parent_code": "<string>"
}
],
"has_more": true,
"cursor": "<string>"
}{
"detail": "Property foo is required but is missing.",
"error_code": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"resolve": {
"message": "<string>",
"action": "<string>",
"endpoint": "<string>",
"method": "<string>",
"url": "<string>"
},
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}{
"detail": "Property foo is required but is missing.",
"error_code": "<string>",
"errors": [
{
"location": "<string>",
"message": "<string>",
"value": "<unknown>"
}
],
"instance": "https://example.com/error-log/abc123",
"resolve": {
"message": "<string>",
"action": "<string>",
"endpoint": "<string>",
"method": "<string>",
"url": "<string>"
},
"status": 400,
"title": "Bad Request",
"type": "https://example.com/errors/example"
}Authorizations
Pass your API key in the X-API-Key header (recommended).
Query Parameters
Results per page (default: all)
1 <= x <= 100Opaque pagination cursor from previous response
Occupation standard to browse: soc_2018 (US Standard Occupational Classification; major groups, then 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).
soc_2018, isco_08 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.
200Search 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.
200Was this page helpful?