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

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

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