Skip navigation

Reference Manual

The Related DWA search consists of three parts:

  1. The user selects their current occupation through a keyword search.
  2. The user selects one or more activities from that occupation.
  3. Related occupations are shown which share those activities.

To learn more about the search, see the following technical report:

https://services.onetcenter.org/ws/online/related_dwa/search?keyword=[phrase or code]
JSON XML
{
   "keyword" : "pharmacist",
   "start" : 1,
   "end" : 5,
   "total" : 5,
   "occupation" : [
      {
         "href" : "https://services.onetcenter.org/ws/online/related_dwa/activities/29-1051.00",
         "code" : "29-1051.00",
         "title" : "Pharmacists",
         "tags" : {
            "bright_outlook" : false,
            "green" : false
         }
      },
      {
         "href" : "https://services.onetcenter.org/ws/online/related_dwa/activities/29-2052.00",
         "code" : "29-2052.00",
         "title" : "Pharmacy Technicians",
         "tags" : {
            "bright_outlook" : true,
            "green" : false
         }
      },
      ...
   ]
}

This response implements the current occupation selection. Like the keyword search, call this service with an O*NET-SOC code, job title, or key words. Each occupation element contains a href attribute linking to the next step of the search.

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.

DWAs in occupation

https://services.onetcenter.org/ws/online/related_dwa/activities/[O*NET-SOC code]
JSON XML
{
   "code" : "29-1051.00",
   "start" : 1,
   "end" : 18,
   "total" : 18,
   "activity" : [
      {
         "id" : "4.A.2.a.2.I05.D04",
         "name" : "Verify accuracy of patient information."
      },
      {
         "id" : "4.A.4.b.6.I01.D04",
         "name" : "Advise patients on effects of health conditions or treatments."
      },
      {
         "id" : "4.A.4.a.1.I05.D01",
         "name" : "Communicate detailed medical information to patients or family members."
      },
      {
         "id" : "4.A.3.b.6.I11.D02",
         "name" : "Maintain medical facility records."
      },
      ...
   ]
}

This response provides a list of detailed work activities for the selected occupation. Within the Related DWA search, a user chooses one or more activities to find related occupations. Each activity element contains an id attribute for use in the next step of the search.

The result list is paged, returning all activities by default. To limit the results, provide start and end parameters to jump directly to the desired results.

Related occupations for DWAs

https://services.onetcenter.org/ws/online/related_dwa/results/[O*NET-SOC code]?dwas=[list of IDs]
JSON XML
{
   "code" : "29-1051.00",
   "dwas" : "4.A.2.a.2.I05.D04,4.A.4.a.1.I05.D01",
   "start" : 1,
   "end" : 18,
   "total" : 18,
   "occupation" : [
      {
         "href" : "https://services.onetcenter.org/ws/online/occupations/29-1069.05/",
         "code" : "29-1069.05",
         "title" : "Nuclear Medicine Physicians",
         "tags" : {
            "bright_outlook" : true,
            "green" : false
         },
         "shared_activities" : {
            "activity" : [
               {
                  "id" : "4.A.2.a.2.I05.D04",
                  "name" : "Verify accuracy of patient information."
               },
               {
                  "id" : "4.A.4.a.1.I05.D01",
                  "name" : "Communicate detailed medical information to patients or family members."
               }
            ]
         }
      },
      {
         "href" : "https://services.onetcenter.org/ws/online/occupations/29-9092.00/",
         "code" : "29-9092.00",
         "title" : "Genetic Counselors",
         "tags" : {
            "bright_outlook" : true,
            "green" : false
         },
         "shared_activities" : {
            "activity" : [
               {
                  "id" : "4.A.4.a.1.I05.D01",
                  "name" : "Communicate detailed medical information to patients or family members."
               }
            ]
         }
      },
      ...
   ]
}

This response provides occupations related to a user's current occupation, which share one or more of the selected detailed work activities. Call the service with the O*NET-SOC code of the user's current occupation, and a comma-separated list of the DWA IDs selected in the previous step.

The closest matches are returned first. Each occupation result includes a shared_activities section listing each of the selected DWAs linked to this result occupation.

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