curl -H "X-API-Key: $PARTICLE_API_KEY" \
"https://api.particle.pro/v1/people/occupations/{code}"{
"code": "<string>",
"level": 123,
"slug": "<string>",
"standard": "soc_2018",
"title": "<string>",
"children": [
{
"code": "<string>",
"level": 123,
"slug": "<string>",
"standard": "soc_2018",
"title": "<string>",
"parent_code": "<string>"
}
],
"equivalents": [
{
"code": "<string>",
"level": 123,
"slug": "<string>",
"standard": "soc_2018",
"title": "<string>",
"parent_code": "<string>"
}
],
"parent": {
"code": "<string>",
"level": 123,
"slug": "<string>",
"standard": "soc_2018",
"title": "<string>",
"parent_code": "<string>"
},
"parent_code": "<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"
}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 parameter accepts the code, slug, or title.
curl -H "X-API-Key: $PARTICLE_API_KEY" \
"https://api.particle.pro/v1/people/occupations/{code}"{
"code": "<string>",
"level": 123,
"slug": "<string>",
"standard": "soc_2018",
"title": "<string>",
"children": [
{
"code": "<string>",
"level": 123,
"slug": "<string>",
"standard": "soc_2018",
"title": "<string>",
"parent_code": "<string>"
}
],
"equivalents": [
{
"code": "<string>",
"level": 123,
"slug": "<string>",
"standard": "soc_2018",
"title": "<string>",
"parent_code": "<string>"
}
],
"parent": {
"code": "<string>",
"level": 123,
"slug": "<string>",
"standard": "soc_2018",
"title": "<string>",
"parent_code": "<string>"
},
"parent_code": "<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).
Path Parameters
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.
200Response
OK
The standard's own notation, such as 29-1212 (SOC), 2212 (ISCO), or 320101 (FoR).
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.
The title as a URL segment, such as cardiologists.
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).
soc_2018, isco_08, anzsrc_for_2020 The standard's official title, such as Cardiologists.
Every code one level down; omitted for the most specific level.
Show child attributes
Show child attributes
The same occupation in the other occupation standard, per the official BLS SOC 2018 to ISCO-08 crosswalk: the ISCO groups a SOC occupation maps to, or the SOC occupations that map to an ISCO group. Omitted for fields of research.
Show child attributes
Show child attributes
The code one level up; omitted at the top level and for ISCO-08 codes.
Show child attributes
Show child attributes
Code one level up; omitted at the top level and for every ISCO-08 code, since ISCO-08 is listed without its upper levels.
Was this page helpful?