Skip navigation

Reference Manual (API Version 1.9)

Browse by Job Family

Family listing

https://services.onetcenter.org/v1.9/ws/online/job_families/
JSON XML
{
   "job_family" : [
      {
         "href" : "https://services.onetcenter.org/v1.9/ws/online/job_families/17-0000",
         "code" : "17-0000",
         "title" : "Architecture and Engineering"
      },
      {
         "href" : "https://services.onetcenter.org/v1.9/ws/online/job_families/27-0000",
         "code" : "27-0000",
         "title" : "Arts, Design, Entertainment, Sports, and Media"
      },
      ...
   ]
}

This response lists Job Families. Every O*NET-SOC occupation is grouped under one of these 23 SOC-based families. The href attribute on each family links to a listing of all occupations in that family.

Occupations in family

https://services.onetcenter.org/v1.9/ws/online/job_families/[family code]
JSON XML
{
   "family" : "17-0000",
   "sort" : "name",
   "start" : 1,
   "end" : 20,
   "total" : 59,
   "link" : [
      {
         "href" : "https://services.onetcenter.org/v1.9/ws/online/job_families/17-0000?family=17-0000&sort=name&start=21&end=40",
         "rel" : "next"
      }
   ],
   "occupation" : [
      {
         "href" : "https://services.onetcenter.org/v1.9/ws/online/occupations/17-3021.00/",
         "code" : "17-3021.00",
         "title" : "Aerospace Engineering and Operations Technologists and Technicians",
         "tags" : {
            "bright_outlook" : true,
            "green" : false
         },
         "job_family" : {
            "code" : "17-0000",
            "name" : "Architecture and Engineering"
         }
      },
      {
         "href" : "https://services.onetcenter.org/v1.9/ws/online/occupations/17-2011.00/",
         "code" : "17-2011.00",
         "title" : "Aerospace Engineers",
         "tags" : {
            "bright_outlook" : true,
            "green" : false
         },
         "job_family" : {
            "code" : "17-0000",
            "name" : "Architecture and Engineering"
         }
      },
      ...
   ]
}

This response lists all occupations grouped into the requested Job Family. Instead of a Job Family code, developers may pass the value all to retrieve occupations in any family. The job_family element indicates each result's family.

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
  • family - sort by Job Family (when listing all families)

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