Skip navigation

Reference Manual

Occupation report

Occupation overview (description, job titles)

https://services.onetcenter.org/ws/online/occupations/[O*NET-SOC Code]/
JSON XML
{
   "code" : "17-2051.00",
   "title" : "Civil Engineers",
   "tags" : {
      "bright_outlook" : true,
      "green" : true
   },
   "description" : "Perform engineering duties in planning, designing, and overseeing construction and maintenance of building structures, and facilities, such as roads, railroads, airports, bridges, harbors, channels, dams, irrigation projects, pipelines, power plants, and water and sewage systems.",
   "sample_of_reported_job_titles" : {
      "title" : [
         "Bridge/Structure Inspection Team Leader",
         "City Engineer",
         ...
      ]
   },
   "also_see" : {
      "occupation" : [
         {
            "href" : "https://services.onetcenter.org/ws/online/occupations/17-2051.01/",
            "code" : "17-2051.01",
            "title" : "Transportation Engineers",
            "tags" : {
               "bright_outlook" : true,
               "green" : true
            }
         }
      ]
   },
   "updated" : {
      "partial" : false,
      "year" : 2018,
      "resource_updated" : [
         {
            "title" : "Abilities",
            "source" : "Analyst",
            "year" : 2014
         },
         ...
      ]
   },
   "bright_outlook" : {
      "description" : "This occupation is expected to grow rapidly.",
      "category" : [
         "Grow Rapidly"
      ]
   },
   "green" : {
      "description" : "Green economy activities and technologies are likely to cause significant change to the work and worker requirements. New tasks, skills, knowledge, credentials may be needed. Employment demand remains the same, but there is potential for an increase.",
      "category" : "Green Enhanced Skills",
      "sectors" : {
         "sector" : [
            "Green Construction",
            "Renewable Energy Generation",
            "Research, Design, and Consulting Services"
         ]
      }
   },
   "summary_resources" : {
      "resource" : [
         {
            "href" : "https://services.onetcenter.org/ws/online/occupations/17-2051.00/summary/tasks",
            "title" : "Tasks"
         },
         ...
      ]
   },
   "details_resources" : {
      "resource" : [
         {
            "href" : "https://services.onetcenter.org/ws/online/occupations/17-2051.00/details/tasks",
            "title" : "Tasks"
         },
         ...
      ]
   },
   "custom_resources" : {
      "resource" : [
         {
            "href" : "https://services.onetcenter.org/ws/online/occupations/17-2051.00/custom/work_activities_outline",
            "title" : "Work Activities Outline"
         }
      ]
   }
}

This response covers a single occupation's title, description, and other information. In O*NET OnLine, this information is presented at the top of the occupation's Summary and Details reports. Not all elements are present, depending on the data available in the occupation. The following elements may be present:

  • code - the O*NET-SOC code for the occupation. See the O*NET-SOC Taxonomy page for more information.
  • title - the O*NET-SOC title.
  • tags - indicates whether the occupation is considered a Bright Outlook or Green occupation.
  • description - the O*NET-SOC description.
  • sample_of_reported_job_titles - a sample of job titles reported during the O*NET data collection process. Job titles are not available for all occupations.
  • notice - for occupations which have not been comprehensively updated through the O*NET data collection program, a message is returned explaining why complete data is not available.
  • also_see - for SOC level occupations, links to any detailed O*NET-SOC occupations are included here.
  • updated - information on the year and source of this occupation's data is provided here. The partial attribute is true if the occupation has not been comprehensively updated through the O*NET data collection program.
  • bright_outlook - present if the occupation meets Bright Outlook criteria. One or more category elements are returned to indicate the criteria matched:
    • Grow Rapidly - the occupation is expected to grow rapidly
    • Openings - the occupation is projected to have large numbers of job openings
    • New & Emerging - this is a new and emerging occupation
  • green - present when the career has been identified as part of the green economy. One of three category values is returned:
    • Green Increased Demand - the green economy will increase the demand for this type of work
    • Green Enhanced Skills - the green economy will change the work and skills needed on the job
    • Green New & Emerging - the occupation represents a new type of work created by the green economy
    The element also includes a list of green economy sectors where workers in this occupation are employed.

O*NET OnLine indicates Bright Outlook and Green occupations using graphics, as shown below. Developers can download multiple sizes and formats from the O*NET Graphics page.

Bright Outlook       Green

The summary_resources, details_resources, and custom_resources elements list the individual Summary, Details, and Custom report services available for this occupation. These web services are explained below. Some services are not available for all occupations.

In this section