Skip navigation

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 food preparation workers, dishwashers, floor sanders and finishers, landscaping and groundskeeping workers, logging equipment operators, and baristas.",
         "svp_range" : "(Below 4.0)"
      },
      ...
   ]
}

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" : 293,
   "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
      },
      ...
   ]
}

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.

In this section