Skip navigation

Reference Manual (API Version 1.9)

Taxonomy Services

With the release of the O*NET 25.1 Database in November 2020, O*NET Web Services transitioned to the O*NET-SOC 2019 taxonomy. This taxonomy, based on the 2018 SOC, introduced several changes to the occupations returned by our services. For more information on these changes, see the Occupation Taxonomy page at the O*NET Resource Center.

To help with this taxonomy transition, the services below enable developers to connect occupational data between existing systems based on the previous O*NET-SOC 2010 taxonomy, and the current O*NET-SOC 2019 taxonomy-based O*NET Web Services.

Common use cases

To use O*NET Web Services in conjunction with other O*NET-SOC systems throughout the transition period, developers may implement the following steps:

  • To convert an O*NET-SOC code in the 2010 taxonomy for use in a request to O*NET Web Services, use the 2010 to active service.
  • To convert an O*NET-SOC code received from O*NET Web Services for use in an external system based on the 2010 taxonomy, use the active to 2010 service.
  • To upgrade stored occupational data from the 2010 taxonomy to the 2019 taxonomy, use the 2010 to 2019 service. After the upgrade, the data can be used in requests to O*NET Web Services without conversion.

O*NET-SOC 2010 to active O*NET-SOC crosswalk

https://services.onetcenter.org/v1.9/ws/taxonomy/2010_to_active?code=[O*NET-SOC 2010 code]
JSON XML
{
   "code" : "25-2052.00",
   "title" : "Special Education Teachers, Kindergarten and Elementary School",
   "description" : "Teach elementary school subjects to educationally and physically handicapped students. Includes teachers who specialize and work with audibly and visually handicapped students and those who teach basic academic and life processes skills to the mentally impaired.",
   "occupation" : [
      {
         "code" : "25-2055.00",
         "title" : "Special Education Teachers, Kindergarten",
         "description" : "Teach academic, social, and life skills to kindergarten students with learning, emotional, or physical disabilities. Includes teachers who specialize and work with students who are blind or have visual impairments; students who are deaf or have hearing impairments; and students with intellectual disabilities."
      },
      {
         "code" : "25-2056.00",
         "title" : "Special Education Teachers, Elementary School",
         "description" : "Teach academic, social, and life skills to elementary school students with learning, emotional, or physical disabilities. Includes teachers who specialize and work with students who are blind or have visual impairments; students who are deaf or have hearing impairments; and students with intellectual disabilities."
      }
   ]
}

This response provides O*NET-SOC occupations, in the taxonomy currently used by O*NET Web Services, linked to the provided occupation from the O*NET-SOC 2010 taxonomy. The parameter code is required, and must correspond to a valid O*NET-SOC 2010 code.

For reference, the 2010 title and description are provided, as well as one or more relevant O*NET-SOC 2019 occupations suitable for use in other O*NET Web Services requests. The code, title, and description are provided for each linked occupation.

Active O*NET-SOC to O*NET-SOC 2010 crosswalk

https://services.onetcenter.org/v1.9/ws/taxonomy/active_to_2010?code=[O*NET-SOC code]
JSON XML
{
   "code" : "25-1192.00",
   "title" : "Family and Consumer Sciences Teachers, Postsecondary",
   "description" : "Teach courses in childcare, family relations, finance, nutrition, and related subjects pertaining to home management. Includes both teachers primarily engaged in teaching and those who do a combination of teaching and research.",
   "occupation" : [
      {
         "code" : "25-1192.00",
         "title" : "Home Economics Teachers, Postsecondary",
         "description" : "Teach courses in childcare, family relations, finance, nutrition, and related subjects pertaining to home management. Includes both teachers primarily engaged in teaching and those who do a combination of teaching and research."
      }
   ]
}

This response provides O*NET-SOC 2010 occupations linked to the provided occupation from the O*NET-SOC taxonomy currently used by O*NET Web Services. The parameter code is required, and must correspond to a valid O*NET-SOC code obtained as the result of a previous O*NET Web Services request.

For reference, the input title and description are provided, as well as one or more relevant occupations from the O*NET-SOC 2010 taxonomy. Relevant occupations are listed for the provided 2019 taxonomy code. Note: some occupations in the 2019 taxonomy are newly introduced and do not have linkages to 2010 occupations; for these cases, see the O*NET-SOC Taxonomy page at the O*NET Resource Center. When links are available, the 2010 code, title, and description are provided for each linked occupation.

O*NET-SOC 2019 to active O*NET-SOC crosswalk

https://services.onetcenter.org/v1.9/ws/taxonomy/2019_to_active?code=[O*NET-SOC 2019 code]
JSON XML
{
   "code" : "35-3023.00",
   "title" : "Fast Food and Counter Workers",
   "description" : "Perform duties such as taking orders and serving food and beverages. Serve customers at counter or from a steam table. May take payment. May prepare food and beverages.",
   "occupation" : [
      {
         "code" : "35-3023.00",
         "title" : "Fast Food and Counter Workers",
         "description" : "Perform duties such as taking orders and serving food and beverages. Serve customers at counter or from a steam table. May take payment. May prepare food and beverages."
      }
   ]
}

This response provides O*NET-SOC occupations, in the taxonomy currently used by O*NET Web Services, linked to the provided occupation from the O*NET-SOC 2019 taxonomy. The parameter code is required, and must correspond to a valid O*NET-SOC 2019 code.

For reference, the 2019 title and description are provided, as well the relevant occupation suitable for use in other O*NET Web Services requests. Because O*NET Web Services currently uses the 2019 taxonomy, the linked occupation will be identical to the input occupation.

Active O*NET-SOC to O*NET-SOC 2019 crosswalk

https://services.onetcenter.org/v1.9/ws/taxonomy/active_to_2019?code=[O*NET-SOC 2010 code]
JSON XML
{
   "code" : "25-1192.00",
   "title" : "Family and Consumer Sciences Teachers, Postsecondary",
   "description" : "Teach courses in childcare, family relations, finance, nutrition, and related subjects pertaining to home management. Includes both teachers primarily engaged in teaching and those who do a combination of teaching and research.",
   "occupation" : [
      {
         "code" : "25-1192.00",
         "title" : "Family and Consumer Sciences Teachers, Postsecondary",
         "description" : "Teach courses in childcare, family relations, finance, nutrition, and related subjects pertaining to home management. Includes both teachers primarily engaged in teaching and those who do a combination of teaching and research."
      }
   ]
}

This response provides O*NET-SOC 2019 occupations linked to the provided occupation from the O*NET-SOC taxonomy currently used by O*NET Web Services. The parameter code is required, and must correspond to a valid O*NET-SOC code obtained as the result of a previous O*NET Web Services request.

For reference, the input title and description are provided, as well as the linked occupation’s code, title, and description. Because O*NET Web Services currently uses the 2019 taxonomy, the linked occupation will be identical to the input occupation.

O*NET-SOC 2010 to O*NET-SOC 2019 crosswalk

https://services.onetcenter.org/v1.9/ws/taxonomy/2010_to_2019?code=[O*NET-SOC 2010 code]
JSON XML
{
   "code" : "25-2052.00",
   "title" : "Special Education Teachers, Kindergarten and Elementary School",
   "description" : "Teach elementary school subjects to educationally and physically handicapped students. Includes teachers who specialize and work with audibly and visually handicapped students and those who teach basic academic and life processes skills to the mentally impaired.",
   "occupation" : [
      {
         "code" : "25-2055.00",
         "title" : "Special Education Teachers, Kindergarten",
         "description" : "Teach academic, social, and life skills to kindergarten students with learning, emotional, or physical disabilities. Includes teachers who specialize and work with students who are blind or have visual impairments; students who are deaf or have hearing impairments; and students with intellectual disabilities."
      },
      {
         "code" : "25-2056.00",
         "title" : "Special Education Teachers, Elementary School",
         "description" : "Teach academic, social, and life skills to elementary school students with learning, emotional, or physical disabilities. Includes teachers who specialize and work with students who are blind or have visual impairments; students who are deaf or have hearing impairments; and students with intellectual disabilities."
      }
   ]
}

This response provides O*NET-SOC 2019 occupations relevant to the provided occupation from the O*NET-SOC 2010 taxonomy. The parameter code is required, and must correspond to a valid O*NET-SOC 2010 code.

For reference, the 2010 title and description are provided, as well as one or more relevant occupations from the O*NET-SOC 2019 taxonomy. Every occupation in the 2010 taxonomy is linked to at least one occupation in the 2019 taxonomy, to provide continuity when migrating data. The 2019 code, title, and description are provided for each linked occupation.

O*NET-SOC 2019 to O*NET-SOC 2010 crosswalk

https://services.onetcenter.org/v1.9/ws/taxonomy/2019_to_2010?code=[O*NET-SOC 2019 code]
JSON XML
{
   "code" : "35-3023.00",
   "title" : "Fast Food and Counter Workers",
   "description" : "Perform duties such as taking orders and serving food and beverages. Serve customers at counter or from a steam table. May take payment. May prepare food and beverages.",
   "occupation" : [
      {
         "code" : "35-3021.00",
         "title" : "Combined Food Preparation and Serving Workers, Including Fast Food",
         "description" : "Perform duties which combine preparing and serving food and nonalcoholic beverages."
      },
      {
         "code" : "35-3022.00",
         "title" : "Counter Attendants, Cafeteria, Food Concession, and Coffee Shop",
         "description" : "Serve food to diners at counter or from a steam table."
      }
   ]
}

This response provides O*NET-SOC 2010 occupations linked to the provided occupation from the O*NET-SOC 2019 taxonomy. The parameter code is required, and must correspond to a valid O*NET-SOC 2019 code.

For reference, the 2019 title and description are provided, as well as one or more relevant occupations from the O*NET-SOC 2010 taxonomy. Note: some occupations in the 2019 taxonomy are newly introduced and do not have linkages to 2010 occupations; for these cases, see the O*NET-SOC Taxonomy page at the O*NET Resource Center. When links are available, the 2010 code, title, and description are provided for each linked occupation.