Reference Manual (API Version 1.9)
Browse by Job Zone
Job Zone listing
https://services.onetcenter.org/v1.9/ws/online/job_zones/
JSON
XML
{
"job_zone" : [
{
"href" : "https://services.onetcenter.org/v1.9/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 agricultural equipment operators, dishwashers, floor sanders and finishers, landscaping and groundskeeping workers, logging equipment operators, baristas, and maids and housekeeping cleaners.",
"svp_range" : "(Below 4.0)"
},
...
]
}
"job_zone" : [
{
"href" : "https://services.onetcenter.org/v1.9/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 agricultural equipment operators, dishwashers, floor sanders and finishers, landscaping and groundskeeping workers, logging equipment operators, baristas, and maids and housekeeping cleaners.",
"svp_range" : "(Below 4.0)"
},
...
]
}
JSON
XML
<job_zones>
<job_zone href="https://services.onetcenter.org/v1.9/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 agricultural equipment operators, dishwashers, floor sanders and finishers, landscaping and groundskeeping workers, logging equipment operators, baristas, and maids and housekeeping cleaners.</job_zone_examples>
<svp_range>(Below 4.0)</svp_range>
</job_zone>
...
</job_zones>
<job_zone href="https://services.onetcenter.org/v1.9/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 agricultural equipment operators, dishwashers, floor sanders and finishers, landscaping and groundskeeping workers, logging equipment operators, baristas, and maids and housekeeping cleaners.</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.9/ws/online/job_zones/[zone number]
JSON
XML
{
"zone" : 2,
"sort" : "name",
"start" : 1,
"end" : 20,
"total" : 295,
"link" : [
{
"href" : "https://services.onetcenter.org/v1.9/ws/online/job_zones/2?zone=2&sort=name&start=21&end=40",
"rel" : "next"
}
],
"occupation" : [
{
"href" : "https://services.onetcenter.org/v1.9/ws/online/occupations/27-2011.00/",
"code" : "27-2011.00",
"title" : "Actors",
"tags" : {
"bright_outlook" : false,
"green" : false
},
"job_zone" : 2
},
{
"href" : "https://services.onetcenter.org/v1.9/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" : 295,
"link" : [
{
"href" : "https://services.onetcenter.org/v1.9/ws/online/job_zones/2?zone=2&sort=name&start=21&end=40",
"rel" : "next"
}
],
"occupation" : [
{
"href" : "https://services.onetcenter.org/v1.9/ws/online/occupations/27-2011.00/",
"code" : "27-2011.00",
"title" : "Actors",
"tags" : {
"bright_outlook" : false,
"green" : false
},
"job_zone" : 2
},
{
"href" : "https://services.onetcenter.org/v1.9/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="295">
<link href="https://services.onetcenter.org/v1.9/ws/online/job_zones/2?zone=2&sort=name&start=21&end=40" rel="next" />
<occupation href="https://services.onetcenter.org/v1.9/ws/online/occupations/27-2011.00/">
<code>27-2011.00</code>
<title>Actors</title>
<tags bright_outlook="false" green="false" />
<job_zone>2</job_zone>
</occupation>
<occupation href="https://services.onetcenter.org/v1.9/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.9/ws/online/job_zones/2?zone=2&sort=name&start=21&end=40" rel="next" />
<occupation href="https://services.onetcenter.org/v1.9/ws/online/occupations/27-2011.00/">
<code>27-2011.00</code>
<title>Actors</title>
<tags bright_outlook="false" green="false" />
<job_zone>2</job_zone>
</occupation>
<occupation href="https://services.onetcenter.org/v1.9/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.