Skip navigation

Reference Manual (API Version 1.9)

Browse by Career Cluster

Cluster listing

https://services.onetcenter.org/v1.9/ws/online/career_clusters/
JSON XML
{
   "career_cluster" : [
      {
         "href" : "https://services.onetcenter.org/v1.9/ws/online/career_clusters/1.0000",
         "code" : "1.0000",
         "title" : "Agriculture, Food & Natural Resources"
      },
      {
         "href" : "https://services.onetcenter.org/v1.9/ws/online/career_clusters/2.0000",
         "code" : "2.0000",
         "title" : "Architecture & Construction"
      },
      ...
   ]
}

This response lists Career Clusters, which group occupations in the same field of work that require similar skills. The href attribute on each cluster links to a listing of all occupations in that cluster.

Career Clusters and occupation linkages come from the National Career Clusters® Framework external site implemented by Department of Defense ASVAB Career Exploration Program (updated 2016).

Occupations in cluster

https://services.onetcenter.org/v1.9/ws/online/career_clusters/[cluster code]
JSON XML
{
   "cluster" : "16.0000",
   "sort" : "pathway",
   "start" : 1,
   "end" : 20,
   "total" : 72,
   "link" : [
      {
         "href" : "https://services.onetcenter.org/v1.9/ws/online/career_clusters/16.0000?cluster=16.0000&sort=pathway&start=21&end=40",
         "rel" : "next"
      }
   ],
   "occupation" : [
      {
         "href" : "https://services.onetcenter.org/v1.9/ws/online/occupations/49-3011.00/",
         "code" : "49-3011.00",
         "title" : "Aircraft Mechanics and Service Technicians",
         "tags" : {
            "bright_outlook" : false,
            "green" : false
         },
         "career_cluster" : {
            "code" : "16.0000",
            "title" : "Transportation, Distribution & Logistics"
         },
         "career_pathway" : {
            "code" : "16.4000",
            "title" : "Facility and Mobile Equipment Maintenance"
         }
      },
      {
         "href" : "https://services.onetcenter.org/v1.9/ws/online/occupations/53-6031.00/",
         "code" : "53-6031.00",
         "title" : "Automotive and Watercraft Service Attendants",
         "tags" : {
            "bright_outlook" : false,
            "green" : false
         },
         "career_cluster" : {
            "code" : "16.0000",
            "title" : "Transportation, Distribution & Logistics"
         },
         "career_pathway" : {
            "code" : "16.4000",
            "title" : "Facility and Mobile Equipment Maintenance"
         }
      },
      ...
   ]
}

This response lists all occupations grouped into the requested Career Cluster. Instead of a Career Cluster code, developers may pass the value all to retrieve occupations in any cluster. The career_cluster element indicates each result's cluster.

Each result also includes a career_pathway element. Pathways are more specific areas within a cluster.

By default, returned occupations are sorted by Career Pathway and then by occupation title. When the value all is used, occupations are sorted by Career Cluster. You can change this by passing the optional sort parameter:

  • pathway - sort by Career Pathway (default)
  • name - sort by occupation title
  • code - sort by O*NET-SOC code
  • cluster - sort by Career Cluster (default when listing all clusters)

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