Reference Manual (API Version 1.8)
Notice: the Web Services API will be upgraded on March 5, 2019. See the API Version 1.9 page for more information.
Browse by Job Zone
Job Zone listing
https://services.onetcenter.org/v1.8/ws/online/job_zones/
JSON
XML
{
"job_zone" : [
{
"href" : "https://services.onetcenter.org/v1.8/ws/online/job_zones/1",
"value" : 1,
"title" : "Job Zone One: Little or No Preparation Needed",
"education" : "Some of these occupations may require a high school diploma or GED certificate.",
"related_experience" : "Little or no previous work-related skill, knowledge, or experience is needed for these occupations. For example, a person can become a waiter or waitress even if he/she has never worked before.",
"job_training" : "Employees in these occupations need anywhere from a few days to a few months of training. Usually, an experienced worker could show you how to do the job.",
"job_zone_examples" : "These occupations involve following instructions and helping others. Examples include food preparation workers, dishwashers, floor sanders and finishers, landscaping and groundskeeping workers, logging equipment operators, and baristas.",
"svp_range" : "(Below 4.0)"
},
...
]
}
"job_zone" : [
{
"href" : "https://services.onetcenter.org/v1.8/ws/online/job_zones/1",
"value" : 1,
"title" : "Job Zone One: Little or No Preparation Needed",
"education" : "Some of these occupations may require a high school diploma or GED certificate.",
"related_experience" : "Little or no previous work-related skill, knowledge, or experience is needed for these occupations. For example, a person can become a waiter or waitress even if he/she has never worked before.",
"job_training" : "Employees in these occupations need anywhere from a few days to a few months of training. Usually, an experienced worker could show you how to do the job.",
"job_zone_examples" : "These occupations involve following instructions and helping others. Examples include food preparation workers, dishwashers, floor sanders and finishers, landscaping and groundskeeping workers, logging equipment operators, and baristas.",
"svp_range" : "(Below 4.0)"
},
...
]
}
JSON
XML
<job_zones>
<job_zone href="https://services.onetcenter.org/v1.8/ws/online/job_zones/1">
<value>1</value>
<title>Job Zone One: Little or No Preparation Needed</title>
<education>Some of these occupations may require a high school diploma or GED certificate.</education>
<related_experience>Little or no previous work-related skill, knowledge, or experience is needed for these occupations. For example, a person can become a waiter or waitress even if he/she has never worked before.</related_experience>
<job_training>Employees in these occupations need anywhere from a few days to a few months of training. Usually, an experienced worker could show you how to do the job.</job_training>
<job_zone_examples>These occupations involve following instructions and helping others. Examples include food preparation workers, dishwashers, floor sanders and finishers, landscaping and groundskeeping workers, logging equipment operators, and baristas.</job_zone_examples>
<svp_range>(Below 4.0)</svp_range>
</job_zone>
...
</job_zones>
<job_zone href="https://services.onetcenter.org/v1.8/ws/online/job_zones/1">
<value>1</value>
<title>Job Zone One: Little or No Preparation Needed</title>
<education>Some of these occupations may require a high school diploma or GED certificate.</education>
<related_experience>Little or no previous work-related skill, knowledge, or experience is needed for these occupations. For example, a person can become a waiter or waitress even if he/she has never worked before.</related_experience>
<job_training>Employees in these occupations need anywhere from a few days to a few months of training. Usually, an experienced worker could show you how to do the job.</job_training>
<job_zone_examples>These occupations involve following instructions and helping others. Examples include food preparation workers, dishwashers, floor sanders and finishers, landscaping and groundskeeping workers, logging equipment operators, and baristas.</job_zone_examples>
<svp_range>(Below 4.0)</svp_range>
</job_zone>
...
</job_zones>
This response provides information on the five O*NET Job Zones. The href attribute on each zone links to a listing of all occupations in that zone.
Occupations in zone
https://services.onetcenter.org/v1.8/ws/online/job_zones/[zone number]
JSON
XML
{
"zone" : 2,
"sort" : "name",
"start" : 1,
"end" : 20,
"total" : 289,
"link" : [
{
"href" : "https://services.onetcenter.org/v1.8/ws/online/job_zones/2?zone=2&sort=name&start=21&end=40",
"rel" : "next"
}
],
"occupation" : [
{
"href" : "https://services.onetcenter.org/v1.8/ws/online/occupations/27-2011.00/",
"code" : "27-2011.00",
"title" : "Actors",
"tags" : {
"bright_outlook" : true,
"green" : false
},
"job_zone" : 2
},
{
"href" : "https://services.onetcenter.org/v1.8/ws/online/occupations/51-9191.00/",
"code" : "51-9191.00",
"title" : "Adhesive Bonding Machine Operators and Tenders",
"tags" : {
"bright_outlook" : false,
"green" : false
},
"job_zone" : 2
},
...
]
}
"zone" : 2,
"sort" : "name",
"start" : 1,
"end" : 20,
"total" : 289,
"link" : [
{
"href" : "https://services.onetcenter.org/v1.8/ws/online/job_zones/2?zone=2&sort=name&start=21&end=40",
"rel" : "next"
}
],
"occupation" : [
{
"href" : "https://services.onetcenter.org/v1.8/ws/online/occupations/27-2011.00/",
"code" : "27-2011.00",
"title" : "Actors",
"tags" : {
"bright_outlook" : true,
"green" : false
},
"job_zone" : 2
},
{
"href" : "https://services.onetcenter.org/v1.8/ws/online/occupations/51-9191.00/",
"code" : "51-9191.00",
"title" : "Adhesive Bonding Machine Operators and Tenders",
"tags" : {
"bright_outlook" : false,
"green" : false
},
"job_zone" : 2
},
...
]
}
JSON
XML
<occupations zone="2" sort="name" start="1" end="20" total="289">
<link href="https://services.onetcenter.org/v1.8/ws/online/job_zones/2?zone=2&sort=name&start=21&end=40" rel="next" />
<occupation href="https://services.onetcenter.org/v1.8/ws/online/occupations/27-2011.00/">
<code>27-2011.00</code>
<title>Actors</title>
<tags bright_outlook="true" green="false" />
<job_zone>2</job_zone>
</occupation>
<occupation href="https://services.onetcenter.org/v1.8/ws/online/occupations/51-9191.00/">
<code>51-9191.00</code>
<title>Adhesive Bonding Machine Operators and Tenders</title>
<tags bright_outlook="false" green="false" />
<job_zone>2</job_zone>
</occupation>
...
</occupations>
<link href="https://services.onetcenter.org/v1.8/ws/online/job_zones/2?zone=2&sort=name&start=21&end=40" rel="next" />
<occupation href="https://services.onetcenter.org/v1.8/ws/online/occupations/27-2011.00/">
<code>27-2011.00</code>
<title>Actors</title>
<tags bright_outlook="true" green="false" />
<job_zone>2</job_zone>
</occupation>
<occupation href="https://services.onetcenter.org/v1.8/ws/online/occupations/51-9191.00/">
<code>51-9191.00</code>
<title>Adhesive Bonding Machine Operators and Tenders</title>
<tags bright_outlook="false" green="false" />
<job_zone>2</job_zone>
</occupation>
...
</occupations>
This response lists all occupations grouped into the requested Job Zone. Instead of a Job Zone number, developers may pass the value all to retrieve occupations in any zone. The job_zone element indicates each result's Job Zone.
By default, returned occupations are sorted by title. You can change this by passing the optional sort parameter:
- name - sort by occupation title (default)
- code - sort by O*NET-SOC code
- zone - sort by Job Zone (when listing all zones)
The result list is paged, returning 20 occupations at a time by default. To navigate the full set of results, use the link rel="next" and link rel="prev" elements, or provide start and end parameters to jump directly to the desired results.
License
