Skip navigation

Reference Manual

The Related Task search consists of three parts:

  1. The user selects their current occupation through a keyword search.
  2. The user selects one or more task statements from that occupation.
  3. Related occupations are shown which have similar tasks.

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

https://services.onetcenter.org/ws/online/related_task/search?keyword=[phrase or code]
JSON XML
{
   "keyword" : "pharmacist",
   "start" : 1,
   "end" : 5,
   "total" : 5,
   "occupation" : [
      {
         "href" : "https://services.onetcenter.org/ws/online/related_task/tasks/29-1051.00",
         "code" : "29-1051.00",
         "title" : "Pharmacists",
         "tags" : {
            "bright_outlook" : false,
            "green" : false
         }
      },
      {
         "href" : "https://services.onetcenter.org/ws/online/related_task/tasks/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.

Tasks in occupation

https://services.onetcenter.org/ws/online/related_task/tasks/[O*NET-SOC code]
JSON XML
{
   "code" : "29-1051.00",
   "start" : 1,
   "end" : 16,
   "total" : 16,
   "task" : [
      {
         "id" : 1808,
         "green" : false,
         "name" : "Review prescriptions to assure accuracy, to ascertain the needed ingredients, and to evaluate their suitability."
      },
      {
         "id" : 1809,
         "green" : false,
         "name" : "Provide information and advice regarding drug interactions, side effects, dosage, and proper medication storage."
      },
      {
         "id" : 1812,
         "green" : false,
         "name" : "Maintain records, such as pharmacy files, patient profiles, charge system files, inventories, control records for radioactive nuclei, or registries of poisons, narcotics, or controlled drugs."
      },
      {
         "id" : 1820,
         "green" : false,
         "name" : "Plan, implement, or maintain procedures for mixing, packaging, or labeling pharmaceuticals, according to policy and legal requirements, to ensure quality, security, and proper disposal."
      },
      ...
   ]
}

This response provides a list of task statements for the selected occupation. Within the Related Tasks search, a user chooses one or more tasks to find related occupations. Each task element contains an id attribute for use in the next step of the search.

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

Related occupations for tasks

https://services.onetcenter.org/ws/online/related_task/results/[O*NET-SOC code]?tasks=[list of IDs]
JSON XML
{
   "code" : "29-1051.00",
   "tasks" : "1809,1815",
   "start" : 1,
   "end" : 20,
   "total" : 59,
   "link" : [
      {
         "href" : "https://services.onetcenter.org/ws/online/related_task/results/29-1051.00?code=29-1051.00&tasks=1809%2C1815&start=21&end=40",
         "rel" : "next"
      }
   ],
   "occupation" : [
      {
         "href" : "https://services.onetcenter.org/ws/online/occupations/29-9092.00/",
         "code" : "29-9092.00",
         "title" : "Genetic Counselors",
         "tags" : {
            "bright_outlook" : true,
            "green" : false
         },
         "related_tasks" : {
            "task" : [
               {
                  "id" : 17506,
                  "green" : false,
                  "name" : "Discuss testing options and the associated risks, benefits and limitations with patients and families to assist them in making informed decisions."
               },
               {
                  "id" : 17504,
                  "green" : false,
                  "name" : "Provide counseling to patient and family members by providing information, education, or reassurance."
               },
               ...
            ]
         }
      },
      {
         "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
         },
         "related_tasks" : {
            "task" : [
               {
                  "id" : 17158,
                  "green" : false,
                  "name" : "Interpret imaging data and confer with other medical specialists to formulate diagnoses."
               },
               {
                  "id" : 17142,
                  "green" : false,
                  "name" : "Advise other physicians of the clinical indications, limitations, assessments, or risks of diagnostic and therapeutic applications of radioactive materials."
               },
               ...
            ]
         }
      },
      ...
   ]
}

This response provides occupations related to a user's current occupation, which perform tasks similar to the selected tasks. Call the service with the O*NET-SOC code of the user's current occupation, and a comma-separated list of the task IDs selected in the previous step.

The closest matches are returned first. Each occupation result includes a related_tasks section listing each of the similar tasks performed by 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