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 will transition to the O*NET-SOC 2019 taxonomy. This taxonomy, based on the 2018 SOC, introduces several changes to the occupations returned by our services. It includes 1,016 occupational titles, 923 of which represent O*NET data-level occupations. For more information on these changes, see the O*NET-SOC Taxonomy page at the O*NET Resource Center.

To help with the upcoming taxonomy transition, the services below enable developers to connect occupational data between existing systems based on the O*NET-SOC 2010 taxonomy, and the future O*NET-SOC 2019 taxonomy-based O*NET Web Services. Note: If you are not connecting to data outside of O*NET Web Services, then the conversion will happen automatically and no action will be required.

Note: To programmatically determine the taxonomy currently in use by O*NET Web Services, see the About O*NET Web Services documentation.

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. If you upgrade prior to the 25.1 database transition, use the 2019 to active and active to 2019 services to connect O*NET Web Services to your stored data.

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-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."
      }
   ]
}

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 occupations suitable for use in other O*NET Web Services requests. Prior to the 25.1 database transition, the linked occupation will be identical to the input occupation; after the transition, the linked occupations will be in the 2019 taxonomy. 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" : "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.",
   "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. Prior to the 25.1 database transition, the linked occupation will be identical to the input occupation; after the transition, relevant occupations will be 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-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 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 as one or more relevant occupations suitable for use in other O*NET Web Services requests. Prior to the 25.1 database transition, these occupations will be in the 2010 taxonomy; after the transition, the linked occupation will be identical to the input occupation. 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 code, title, and description are provided for each linked 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" : "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.",
   "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 one or more relevant occupations from the O*NET-SOC 2010 taxonomy. Prior to the 25.1 database transition, one or more linked occupations from the 2019 taxonomy will be returned; after the transition, the linked occupation will be identical to the input occupation. The 2019 code, title, and description are provided for each linked 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.