Reference Manual (API Version 2.0)

All Categories

Getting started

My Next Move Services

Mi Próximo Paso Services

My Next Move for Veterans Services

O*NET OnLine Services

Taxonomy Services

Database Services

Overview

Migrating from version 1.9

Account management

Browse careers by industry

O*NET Interest Profiler

Career listings

Career report

Browse careers by industry

O*NET Interest Profiler

Career listings

Career report

Browse careers by industry

Career listings

Career report

Find occupations

Advanced searches

O*NET data

Crosswalk searches

Occupation reports

Careers with a Bright Outlook

Browse careers by cluster

Careers sorted by Interests

Careers sorted by Job Preparation

Careers with a Bright Outlook

Browse careers by cluster

Careers sorted by Interests

Careers sorted by Job Preparation

Careers with a Bright Outlook

Browse careers by cluster

Careers sorted by Interests

Careers sorted by Job Preparation

Browse Bright Outlook occupations

Browse by Career Cluster

Browse by Hot Technology

Browse by Industry

Browse by Job Family

Browse by Job Zone

Browse STEM occupations

Job duties custom list

Professional associations search

Related activities search

Soft skills custom list

Technology skills search

Abilities

Interests

Knowledge

Skills (Basic)

Skills (Cross-Functional)

Work Activities

Work Context

Work Styles

Work Values

Summary report

Details report

Custom report

Occupation reports

Occupation overview (description, job titles)

https://api-v2.onetcenter.org/online/occupations/[O*NET-SOC Code]/

{
   "code": "17-2051.00",
   "title": "Civil Engineers",
   "tags": {
      "bright_outlook": 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_titles": [
      "City Engineer",
      "Civil Engineer",
      "County Engineer",
      ...
   ],
   "also_see": [
      {
         "href": "https://api-v2.onetcenter.org/online/occupations/17-2051.01/",
         "code": "17-2051.01",
         "title": "Transportation Engineers",
         "tags": {
            "bright_outlook": true
         }
      },
      ...
   ],
   "bright_outlook": [
      {
         "code": "grow",
         "title": "Rapid Growth"
      }
   ],
   "updated": {
      "year": 2025,
      "contents": [
         {
            "title": "Abilities",
            "source": "Analyst",
            "year": 2021
         },
         ...
      ]
   },
   "summary_contents": [
      {
         "href": "https://api-v2.onetcenter.org/online/occupations/17-2051.00/summary/tasks",
         "title": "Tasks"
      },
      {
         "href": "https://api-v2.onetcenter.org/online/occupations/17-2051.00/summary/technology_skills",
         "title": "Technology Skills"
      },
      ...
   ],
   "details_contents": [
      {
         "href": "https://api-v2.onetcenter.org/online/occupations/17-2051.00/details/tasks",
         "title": "Tasks"
      },
      {
         "href": "https://api-v2.onetcenter.org/online/occupations/17-2051.00/details/technology_skills",
         "title": "Technology Skills"
      },
      ...
   ],
   "custom_contents": [
      {
         "href": "https://api-v2.onetcenter.org/online/occupations/17-2051.00/custom/work_activities_outline",
         "title": "Work Activities Outline"
      }
   ]
}

Interactive demo • View at O*NET OnLine

Field	Type
code	string
title	string
tags (contains nested items)	object
bright_outlook (nested at level 1) optional	boolean
description	string
sample_of_reported_titles optional	list of strings
also_see (contains nested items) optional	list of objects
href (nested at level 1)	string
code (nested at level 1)	string
title (nested at level 1)	string
tags (nested at level 1) (contains nested items)	object
bright_outlook (nested at level 2) optional	boolean
bright_outlook (contains nested items) optional	list of objects
code (nested at level 1)	string
title (nested at level 1)	string
updated (contains nested items) optional	object
year (nested at level 1)	integer
contents (nested at level 1) (contains nested items)	list of objects
title (nested at level 2)	string
source (nested at level 2) optional	string
year (nested at level 2) optional	integer
summary_contents (contains nested items)	list of objects
href (nested at level 1)	string
title (nested at level 1)	string
details_contents (contains nested items)	list of objects
href (nested at level 1)	string
title (nested at level 1)	string
custom_contents (contains nested items)	list of objects
href (nested at level 1)	string
title (nested at level 1)	string

Path parameters

Component	Type
O*NET-SOC Code	string

Query string parameters

(none)

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 properties are present, depending on the data available in the occupation. The following properties 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 occupation.
description - the O*NET-SOC description.
sample_of_reported_titles - a sample of job titles reported during the O*NET data collection process. Job titles are not available for all occupations.
also_see - for SOC level occupations, links to any detailed O*NET-SOC occupations are included here.
bright_outlook - present if the occupation meets one or more Bright Outlook criteria:
- grow - the occupation is expected to grow rapidly
- openings - the occupation is projected to have large numbers of job openings
- emerging - this is a new and emerging occupation
updated - information on the year and source of this occupation's data is provided here.

O*NET OnLine indicates Bright Outlook occupations using a graphic. Developers can download this graphic in multiple sizes from the Resource Center Graphics section.

The summary_contents, details_contents, and custom_contents properties list the individual Summary, Details, and Custom report services available for this occupation. These services are documented separately. Some services are not available for all occupations.

In this section

Reference Manual (API Version 2.0)

Reference Manual Table of Contents

All Categories

Getting started

My Next Move Services

Mi Próximo Paso Services

My Next Move for Veterans Services

O*NET OnLine Services

Taxonomy Services

Database Services

Overview

Migrating from version 1.9

Account management

Browse careers by industry

O*NET Interest Profiler

Career listings

Career report

Browse careers by industry

O*NET Interest Profiler

Career listings

Career report

Browse careers by industry

Career listings

Career report

Find occupations

Advanced searches

O*NET data

Crosswalk searches

Occupation reports

Careers with a Bright Outlook

Browse careers by cluster

Careers sorted by Interests

Careers sorted by Job Preparation

Careers with a Bright Outlook

Browse careers by cluster

Careers sorted by Interests

Careers sorted by Job Preparation

Careers with a Bright Outlook

Browse careers by cluster

Careers sorted by Interests

Careers sorted by Job Preparation

Browse Bright Outlook occupations

Browse by Career Cluster

Browse by Hot Technology

Browse by Industry

Browse by Job Family

Browse by Job Zone

Browse STEM occupations

Job duties custom list

Professional associations search

Related activities search

Soft skills custom list

Technology skills search

Abilities

Interests

Knowledge

Skills (Basic)

Skills (Cross-Functional)

Work Activities

Work Context

Work Styles

Work Values

Summary report

Details report

Custom report

Related occupations for

Occupation reports

Occupation overview (description, job titles)

Path parameters

Query string parameters

In this section

Logged Out

Log In

Contact Us