Skip navigation

Reference Manual (API Version 1.7) — My Next Move services

Notice: the Web Services API will be upgraded on January 23, 2018. See the API Version 1.8 page for more information.

O*NET Web Services uses a RESTful external site web services API. Currently all resources are read-only and accessed with the GET method. Access is limited to registered developers through HTTP Basic authentication; you can obtain a username and password by signing up for the developer program. Before you sign up, you can try our interactive demo to see the API in action. The services currently use the O*NET 23.1 Database.

My Next Move services

https://services.onetcenter.org/v1.7/ws/mnm/
<resources>
   <resource href="https://services.onetcenter.org/v1.7/ws/mnm/search">
      <title>Search careers with key words</title>
   </resource>
   <resource href="https://services.onetcenter.org/v1.7/ws/mnm/browse/">
      <title>Browse careers by industry</title>
   </resource>
   <resource href="https://services.onetcenter.org/v1.7/ws/mnm/interestprofiler/">
      <title>O*NET Interest Profiler</title>
   </resource>
   <resource href="https://services.onetcenter.org/v1.7/ws/mnm/careers/">
      <title>See all careers</title>
   </resource>
   <resource href="https://services.onetcenter.org/v1.7/ws/mnm/bright_outlook/">
      <title>Careers with a Bright Outlook</title>
   </resource>
   <resource href="https://services.onetcenter.org/v1.7/ws/mnm/green/">
      <title>Careers in the Green Economy</title>
   </resource>
   <resource href="https://services.onetcenter.org/v1.7/ws/mnm/apprenticeship/">
      <title>Careers with Registered Apprenticeships</title>
   </resource>
   <resource href="https://services.onetcenter.org/v1.7/ws/mnm/job_preparation/">
      <title>Careers sorted by Job Preparation</title>
   </resource>
   <resource href="https://services.onetcenter.org/v1.7/ws/mnm/videos/">
      <title>Careers with videos</title>
   </resource>
</resources>

This response lists the resources corresponding to features on the My Next Move website. Each of the resources are described below:

Search careers with key words

https://services.onetcenter.org/v1.7/ws/mnm/search?keyword=[phrase or code]
<careers keyword="architect" start="1" end="20" total="64">
   <link href="https://services.onetcenter.org/v1.7/ws/mnm/search?keyword=architect&amp;start=21&amp;end=40" rel="next" />
   <career href="https://services.onetcenter.org/v1.7/ws/mnm/careers/17-1011.00/">
      <code>17-1011.00</code>
      <title>Architects</title>
      <tags bright_outlook="false" green="true" apprenticeship="false" />
   </career>
   <career href="https://services.onetcenter.org/v1.7/ws/mnm/careers/17-3011.01/">
      <code>17-3011.01</code>
      <title>Architectural Drafters</title>
      <tags bright_outlook="false" green="true" apprenticeship="true" />
   </career>
   ...
</careers>

This response searches for My Next Move careers using a word, phrase, or title. The closest matches are returned first; up to 20 results are returned.

If the service is called with a full or partial O*NET-SOC code, matching results are returned sorted by code. If more than 20 matches are found, the list will be paged; for information on navigating paged results, see the description of the See all careers service.

Browse careers by industry

https://services.onetcenter.org/v1.7/ws/mnm/browse/
<industries>
   <industry href="https://services.onetcenter.org/v1.7/ws/mnm/browse/56">
      <code>56</code>
      <title>Administration &amp; Support Services</title>
   </industry>
   <industry href="https://services.onetcenter.org/v1.7/ws/mnm/browse/71">
      <code>71</code>
      <title>Arts &amp; Entertainment</title>
   </industry>
   ...
</industries>

This response lists each of the industries available to browse. The code element corresponds to a two-digit NAICS external site code. The href parameter indicates the URL of the specific industry resource. Each industry resource lists related careers, as described below.

https://services.onetcenter.org/v1.7/ws/mnm/browse/[industry code]
<careers category="all" sort="category" start="1" end="20" total="61">
   <link href="https://services.onetcenter.org/v1.7/ws/mnm/browse/48?category=all&amp;sort=category&amp;start=21&amp;end=40" rel="next" />
   <career href="https://services.onetcenter.org/v1.7/ws/mnm/careers/53-1011.00/" percent_employed="85" category="Most">
      <code>53-1011.00</code>
      <title>Aircraft Cargo Handling Supervisors</title>
      <tags bright_outlook="false" green="false" apprenticeship="false" />
   </career>
   <career href="https://services.onetcenter.org/v1.7/ws/mnm/careers/49-3011.00/" percent_employed="60" category="Most">
      <code>49-3011.00</code>
      <title>Aircraft Mechanics &amp; Service Technicians</title>
      <tags bright_outlook="false" green="false" apprenticeship="true" />
   </career>
   ...
</careers>

This response lists careers where at least 10% of workers are employed in the selected industry. You can filter this list by passing a category parameter in the query string:

  • all - include all categories (default)
  • Most - most people (over 50%) in these careers work in this industry
  • Some - some people (between 10% and 50%) in these careers work in this industry

By default, the list is sorted by category and then by career title. You can change this by passing a sort parameter in the query string:

  • category - sort by category (default)
  • name - sort by career title
  • bright_outlook - return Bright Outlook careers first
  • green - return Green careers first
  • apprenticeship - return careers with Registered Apprenticeships first
  • percent_employed - sort by percentage of workers employed in the industry

By default, up to 20 matching careers are returned. For information on navigating paged results, see the description of the See all careers service.

For details about each returned career's industry employment, as shown in the "Where do they work?" popup at My Next Move, see the Where do they work? service.

O*NET Interest Profiler

https://services.onetcenter.org/v1.7/ws/mnm/interestprofiler/
<resources>
   <resource href="https://services.onetcenter.org/v1.7/ws/mnm/interestprofiler/questions">
      <title>Interest Profiler Short Form questions (60-question desktop version)</title>
   </resource>
   <resource href="https://services.onetcenter.org/v1.7/ws/mnm/interestprofiler/questions_30">
      <title>Interest Profiler Mini-IP questions (30-question mobile version)</title>
   </resource>
   <resource href="https://services.onetcenter.org/v1.7/ws/mnm/interestprofiler/results">
      <title>Interest Profiler results</title>
   </resource>
   <resource href="https://services.onetcenter.org/v1.7/ws/mnm/interestprofiler/job_zones">
      <title>Interest Profiler Job Zones</title>
   </resource>
   <resource href="https://services.onetcenter.org/v1.7/ws/mnm/interestprofiler/careers">
      <title>Interest Profiler matching careers</title>
   </resource>
</resources>

The O*NET Interest Profiler is a vocational assessment instrument that suggests careers based on work activity preferences. Four resources provide the functionality of the Interest Profiler:

  1. Short Form Questions returns the list of questions asked in the assessment. For mobile applications desiring a shorter questions list, a Mini-IP 30-question variant is available.
  2. Results returns information about a user's interests, based on their Interest Profiler answers.
  3. Job Zones returns informative text about the five O*NET Job Zones, which can be used to filter career results.
  4. Matching careers returns My Next Move careers matching a user's interest results, Interest Profiler answers, or a single selected interest area.

To learn more about the Interest Profiler career exploration tool, see the Interest Profiler Short Form and Mini-IP pages at the O*NET Resource Center. Developers might also be interested in the following technical reports:

Interest Profiler Short Form questions (60-question desktop version)

https://services.onetcenter.org/v1.7/ws/mnm/interestprofiler/questions
<questions start="1" end="12" total="60">
   <link href="https://services.onetcenter.org/v1.7/ws/mnm/interestprofiler/questions?start=13&amp;end=24" rel="next" />
   <answer_options>
      <answer_option value="1">Strongly Dislike</answer_option>
      <answer_option value="2">Dislike</answer_option>
      <answer_option value="3">Unsure</answer_option>
      <answer_option value="4">Like</answer_option>
      <answer_option value="5">Strongly Like</answer_option>
   </answer_options>
   <question index="1">
      <area>Realistic</area>
      <text>Build kitchen cabinets</text>
   </question>
   <question index="2">
      <area>Realistic</area>
      <text>Lay brick or tile</text>
   </question>
   ...
</questions>

The O*NET Interest Profiler contains 60 questions, each describing a work activity. The assessment taker should be offered five possible answers, describing how they would feel about doing each type of work:

  1. Strongly Dislike
  2. Dislike
  3. Unsure
  4. Like
  5. Strongly Like

These options, and their corresponding values, are provided in the <answer_options> element. The application should record the value of each answer -- 1, 2, 3, 4, or 5 -- and build a string of 60 characters containing all answers in order. This string will be used as the answers parameter for obtaining Interest Profiler results.

Each question pertains to one of six interest areas, given in the <area> element. By default, 12 questions are returned at a time. To navigate the full set of questions, use the link rel="next" and link rel="prev" elements, or provide start and end parameters to jump directly to the desired results.

Interest Profiler Mini-IP questions (30-question mobile version)

https://services.onetcenter.org/v1.7/ws/mnm/interestprofiler/questions_30
<questions start="1" end="12" total="30">
   <link href="https://services.onetcenter.org/v1.7/ws/mnm/interestprofiler/questions_30?start=13&amp;end=24" rel="next" />
   <answer_options>
      <answer_option value="1">Strongly Dislike</answer_option>
      <answer_option value="2">Dislike</answer_option>
      <answer_option value="3">Unsure</answer_option>
      <answer_option value="4">Like</answer_option>
      <answer_option value="5">Strongly Like</answer_option>
   </answer_options>
   <question index="1">
      <area>Realistic</area>
      <text>Build kitchen cabinets</text>
   </question>
   <question index="2">
      <area>Investigative</area>
      <text>Develop a new medicine</text>
   </question>
   ...
</questions>

This version of the O*NET Interest Profiler contains 30 questions, each describing a work activity. This service is offered to developers working on a mobile application or within other time-constrained settings. The full, 60-question desktop version is recommended when possible. The results from either version can be used with the other IP services below.

The assessment taker should be offered five possible answers, describing how they would feel about doing each type of work:

  1. Strongly Dislike
  2. Dislike
  3. Unsure
  4. Like
  5. Strongly Like

Optionally, these choices can be illustrated with the emoji-style graphics shown below. Multiple sizes and formats may be downloaded from the O*NET Resource Center's Graphics page.

Interest Profiler emoji-style graphics

These options, and their corresponding values, are provided in the <answer_options> element. The application should record the value of each answer -- 1, 2, 3, 4, or 5 -- and build a string of 60 characters containing all answers in order. This string will be used as the answers parameter for obtaining Interest Profiler results.

Each question pertains to one of six interest areas, given in the <area> element. By default, 12 questions are returned at a time. To navigate the full set of questions, use the link rel="next" and link rel="prev" elements, or provide start and end parameters to jump directly to the desired results.

Interest Profiler results

https://services.onetcenter.org/v1.7/ws/mnm/interestprofiler/results?answers=[answer string]
<results answers="553421321134342523523523254115342111351145453111231155343444" start="1" end="6" total="6">
   <result>
      <area>Realistic</area>
      <score>27</score>
      <description>People with Realistic interests like work that includes practical, hands-on problems and answers. Often people with Realistic interests do not like careers that involve paperwork or working closely with others. They like working with plants and animals; real-world materials like wood, tools, and machinery; and outside work.</description>
   </result>
   ...
</results>

This response converts a set of Interest Profiler answers into a set of RIASEC scores. This may be used to identify a user's top interest areas. Six <result> elements are returned, with the numeric score and a description of each interest area. The format of the answers parameter is described above.

This response may also be called without the answers parameter. In that event, each interest area and description will be returned, without the score element present. This may be used to retrieve the text related to each interest area without needing a set of Interest Profiler answers; for example, an application may produce a score report based on paper-and-pencil Interest Profiler scores using the descriptions returned.

Interest Profiler Job Zones

https://services.onetcenter.org/v1.7/ws/mnm/interestprofiler/job_zones
<job_zones start="1" end="5" total="5">
   <job_zone value="1">
      <title>Job Zone One: Little or No Preparation Needed</title>
      <experience>Little or no previous work-related skill, knowledge, or experience is needed for these careers. For example, a person can become a waiter or waitress even if he/she has never worked before.</experience>
      <education>Some of these careers may need a high school diploma or GED certificate.</education>
      <job_training>Employees in these careers need from a few days to a few months of training. Usually, an experienced worker can show you how to do the job.</job_training>
      <examples>These careers involve following instructions and helping others. Examples include counter and rental clerks, dishwashers, sewing machine operators, landscaping and groundskeeping workers, logging equipment operators, and baristas.</examples>
      <svp_range>(Below 4.0)</svp_range>
   </job_zone>
   ...
</job_zones>

This response contains information about each of the five O*NET Job Zones. Different careers need different amounts of preparation. Each career in the Interest Profiler is in one of five Job Zones, which are groups of careers that need the same level of experience, education, and training. As described below, a Job Zone may be used to refine the list of occupations matching a user's interest profile. This informational text may be presented to the user to help them select the correct Job Zone for their career exploration.

Interest Profiler matching careers

https://services.onetcenter.org/v1.7/ws/mnm/interestprofiler/careers
<careers answers="553421321134342523523523254115342111351145453111231155343444" start="1" end="17" total="17">
   <career href="https://services.onetcenter.org/v1.7/ws/mnm/careers/27-2031.00/" fit="Best">
      <code>27-2031.00</code>
      <title>Dancers</title>
      <tags bright_outlook="false" green="false" apprenticeship="false" />
   </career>
   <career href="https://services.onetcenter.org/v1.7/ws/mnm/careers/53-3011.00/" fit="Great">
      <code>53-3011.00</code>
      <title>Ambulance Drivers &amp; Attendants</title>
      <tags bright_outlook="true" green="false" apprenticeship="true" />
   </career>
   ...
</careers>

This response returns a list of careers matching the given Interest Profiler answers or interest scores; or occupations in a selected interest area. Exactly one of the following parameter sets must be provided when calling the resource:

  • answers=[answer string] — occupations are matched based on the given Interest Profiler answers. The format of the answers parameter is described above.
  • Realistic=[score] &Investigative=[score] &Artistic=[score] &Social=[score] &Enterprising=[score] &Conventional=[score] — careers are matched based on the given interest scores. These scores may be obtained from the Interest Profiler Results service, or from a source such as the paper-and-pencil Interest Profiler.
  • area=[interest area] — careers most relevant to a single interest area are returned. This may be used to suggest careers outside the matches obtained using a full interest profile. The parameter value should be one of: Realistic, Investigative, Artistic, Social, Enterprising or Conventional.

In addition, an optional parameter may be specified:

  • job_zone=[1-5] — if specified, only careers with the given level of job preparation will be returned. Job Zones are groups of careers that need the same level of experience, education, and training. Note that for some interest profiles, matching careers may not be available in all five Job Zones.

When called using Interest Profiler answers or scores, each career will include a fit attribute, indicating the strength of the match:

  • Best — the career's interest profile is a very strong match to the user's interest profile.
  • Great — the career's interest profile is a strong match to the user's interest profile.
  • Good — the career's interest profile is a less strong match to the user's interest profile.

See all careers

https://services.onetcenter.org/v1.7/ws/mnm/careers/
<careers sort="name" start="1" end="20" total="974">
   <link href="https://services.onetcenter.org/v1.7/ws/mnm/careers/?sort=name&amp;start=21&amp;end=40" rel="next" />
   <career href="https://services.onetcenter.org/v1.7/ws/mnm/careers/13-2011.01/">
      <code>13-2011.01</code>
      <title>Accountants</title>
      <tags bright_outlook="true" green="false" apprenticeship="false" />
   </career>
   <career href="https://services.onetcenter.org/v1.7/ws/mnm/careers/27-2011.00/">
      <code>27-2011.00</code>
      <title>Actors</title>
      <tags bright_outlook="true" green="false" apprenticeship="true" />
   </career>
   ...
</careers>

This response lists all careers available in My Next Move. By default, the list is sorted by career title; you can change this by passing a sort parameter in the query string:

  • name - sort by career title (default)
  • bright_outlook - return Bright Outlook careers first
  • green - return Green careers first
  • apprenticeship - return careers with Registered Apprenticeships first

The list is paged, returning 20 careers at a time by default. To navigate the full set of careers, use the link rel="next" and link rel="prev" elements, or provide start and end parameters to jump directly to the desired results.

Careers with a Bright Outlook

https://services.onetcenter.org/v1.7/ws/mnm/bright_outlook/
<bright_outlook_categories>
   <bright_outlook href="https://services.onetcenter.org/v1.7/ws/mnm/bright_outlook/grow">
      <description>These careers will grow rapidly in the next few years.</description>
      <category>Grow Rapidly</category>
   </bright_outlook>
   <bright_outlook href="https://services.onetcenter.org/v1.7/ws/mnm/bright_outlook/openings">
      <description>These careers will have large numbers of openings.</description>
      <category>Openings</category>
   </bright_outlook>
   <bright_outlook href="https://services.onetcenter.org/v1.7/ws/mnm/bright_outlook/emerging">
      <description>These careers are new and emerging careers.</description>
      <category>New &amp; Emerging</category>
   </bright_outlook>
</bright_outlook_categories>

This response lists each of the categories of careers with a Bright Outlook, where job opportunities are likely in the future. The href parameter indicates the URL of the specific Bright Outlook resource. Each Bright Outlook resource lists matching careers, as described below.

https://services.onetcenter.org/v1.7/ws/mnm/bright_outlook/[category code]
<careers sort="name" start="1" end="20" total="59">
   <link href="https://services.onetcenter.org/v1.7/ws/mnm/bright_outlook/openings?sort=name&amp;start=21&amp;end=40" rel="next" />
   <career href="https://services.onetcenter.org/v1.7/ws/mnm/careers/13-2011.01/">
      <code>13-2011.01</code>
      <title>Accountants</title>
      <tags bright_outlook="true" green="false" apprenticeship="false" />
   </career>
   <career href="https://services.onetcenter.org/v1.7/ws/mnm/careers/29-1141.01/">
      <code>29-1141.01</code>
      <title>Acute Care Nurses</title>
      <tags bright_outlook="true" green="false" apprenticeship="false" />
   </career>
   ...
</careers>

This response lists careers where job opportunities are likely in the future. By default, the list is sorted by career title. You can change this by passing a sort parameter in the query string:

  • name - sort by career title (default)
  • green - return Green careers first
  • apprenticeship - return careers with Registered Apprenticeships first

By default, up to 20 matching careers are returned. For information on navigating paged results, see the description of the See all careers service.

Careers in the Green Economy

https://services.onetcenter.org/v1.7/ws/mnm/green/
<green_categories>
   <green href="https://services.onetcenter.org/v1.7/ws/mnm/green/demand">
      <description>Green jobs will increase the demand for this type of work.</description>
      <category>Increased Demand</category>
   </green>
   <green href="https://services.onetcenter.org/v1.7/ws/mnm/green/changed_work">
      <description>Green jobs will change the work and skills needed.</description>
      <category>Changed Work</category>
   </green>
   <green href="https://services.onetcenter.org/v1.7/ws/mnm/green/emerging">
      <description>Green jobs have created this new and emerging type of work that wasn't around before.</description>
      <category>New &amp; Emerging</category>
   </green>
</green_categories>

This response lists each of the categories of careers in the Green Economy. The href parameter indicates the URL of the specific Green resource. Each Green resource lists matching careers, as described below.

https://services.onetcenter.org/v1.7/ws/mnm/green/[category code]
<careers sort="name" start="1" end="20" total="81">
   <link href="https://services.onetcenter.org/v1.7/ws/mnm/green/demand?sort=name&amp;start=21&amp;end=40" rel="next" />
   <career href="https://services.onetcenter.org/v1.7/ws/mnm/careers/45-2011.00/">
      <code>45-2011.00</code>
      <title>Agricultural Inspectors</title>
      <tags bright_outlook="false" green="true" apprenticeship="false" />
   </career>
   <career href="https://services.onetcenter.org/v1.7/ws/mnm/careers/17-3011.01/">
      <code>17-3011.01</code>
      <title>Architectural Drafters</title>
      <tags bright_outlook="false" green="true" apprenticeship="true" />
   </career>
   ...
</careers>

This response lists careers impacted by Green Economy activities and technologies. By default, the list is sorted by career title. You can change this by passing a sort parameter in the query string:

  • name - sort by career title (default)
  • bright_outlook - return Bright Outlook careers first
  • apprenticeship - return careers with Registered Apprenticeships first

By default, up to 20 matching careers are returned. For information on navigating paged results, see the description of the See all careers service.

Careers with Registered Apprenticeships

https://services.onetcenter.org/v1.7/ws/mnm/apprenticeship/
<careers sort="name" start="1" end="20" total="335">
   <link href="https://services.onetcenter.org/v1.7/ws/mnm/apprenticeship/?sort=name&amp;start=21&amp;end=40" rel="next" />
   <career href="https://services.onetcenter.org/v1.7/ws/mnm/careers/27-2011.00/">
      <code>27-2011.00</code>
      <title>Actors</title>
      <tags bright_outlook="true" green="false" apprenticeship="true" />
   </career>
   <career href="https://services.onetcenter.org/v1.7/ws/mnm/careers/23-1021.00/">
      <code>23-1021.00</code>
      <title>Administrative Law Judges, Adjudicators, &amp; Hearing Officers</title>
      <tags bright_outlook="false" green="false" apprenticeship="true" />
   </career>
   ...
</careers>

This response lists careers which have apprenticeship programs registered with the U.S. Department of Labor. By default, the list is sorted by career title. You can change this by passing a sort parameter in the query string:

  • name - sort by career title (default)
  • bright_outlook - return Bright Outlook careers first
  • green - return Green careers first

By default, up to 20 matching careers are returned. For information on navigating paged results, see the description of the See all careers service.

Careers sorted by Job Preparation

https://services.onetcenter.org/v1.7/ws/mnm/job_preparation/
<job_preparation>
   <job_zone value="1" href="https://services.onetcenter.org/v1.7/ws/mnm/job_preparation/1">
      <title>Job Zone One: Little or No Preparation Needed</title>
      <experience>Little or no previous work-related skill, knowledge, or experience is needed for these careers. For example, a person can become a waiter or waitress even if he/she has never worked before.</experience>
      <education>Some of these careers may need a high school diploma or GED certificate.</education>
      <job_training>Employees in these careers need from a few days to a few months of training. Usually, an experienced worker can show you how to do the job.</job_training>
   </job_zone>
   ...
</job_preparation>

This response lists each of the five Job Zones, which are groups of careers that need the same level of experience, education, and training. The href parameter indicates the URL of a specific job preparation resource. Each job preparation resource lists matching careers, as described below.

https://services.onetcenter.org/v1.7/ws/mnm/job_preparation/[Job Zone]
<careers sort="name" start="1" end="20" total="294">
   <link href="https://services.onetcenter.org/v1.7/ws/mnm/job_preparation/2?sort=name&amp;start=21&amp;end=40" rel="next" />
   <career href="https://services.onetcenter.org/v1.7/ws/mnm/careers/27-2011.00/">
      <code>27-2011.00</code>
      <title>Actors</title>
      <tags bright_outlook="true" green="false" apprenticeship="true" />
   </career>
   <career href="https://services.onetcenter.org/v1.7/ws/mnm/careers/51-9191.00/">
      <code>51-9191.00</code>
      <title>Adhesive Bonding Machine Operators &amp; Tenders</title>
      <tags bright_outlook="false" green="false" apprenticeship="false" />
   </career>
   ...
</careers>

This response lists careers which need similar amounts of preparation, as indicated by the Job Zone. By default, the list is sorted by career title. You can change this by passing a sort parameter in the query string:

  • name - sort by career title (default)
  • bright_outlook - return Bright Outlook careers first
  • green - return Green careers first
  • apprenticeship - return careers with Registered Apprenticeships first

By default, up to 20 matching careers are returned. For information on navigating paged results, see the description of the See all careers service.

Careers with videos

https://services.onetcenter.org/v1.7/ws/mnm/videos/
<careers sort="name" start="1" end="20" total="661">
   <link href="https://services.onetcenter.org/v1.7/ws/mnm/videos/?sort=name&amp;start=21&amp;end=40" rel="next" />
   <career href="https://services.onetcenter.org/v1.7/ws/mnm/careers/13-2011.01/">
      <code>13-2011.01</code>
      <title>Accountants</title>
      <tags bright_outlook="true" green="false" apprenticeship="false" />
   </career>
   <career href="https://services.onetcenter.org/v1.7/ws/mnm/careers/27-2011.00/">
      <code>27-2011.00</code>
      <title>Actors</title>
      <tags bright_outlook="true" green="false" apprenticeship="true" />
   </career>
   ...
</careers>

This response lists careers which have a related video describing the work performed and skills needed. The videos displayed on My Next Move are developed and maintained by CareerOneStop external site. Visit CareerOneStop external site directly for information and options for incorporating the videos.

By default, the list is sorted by career title. You can change this by passing a sort parameter in the query string:

  • name - sort by career title (default)
  • bright_outlook - return Bright Outlook careers first
  • green - return Green careers first
  • apprenticeship - return careers with Registered Apprenticeships first

By default, up to 20 matching careers are returned. For information on navigating paged results, see the description of the See all careers service.

Career overview

https://services.onetcenter.org/v1.7/ws/mnm/careers/[O*NET-SOC Code]/
<career code="17-2071.00">
   <code>17-2071.00</code>
   <title>Electrical Engineers</title>
   <tags bright_outlook="false" green="true" apprenticeship="false" />
   <also_called>
      <title>Design Engineer</title>
      <title>Electrical Engineer</title>
      <title>Project Engineer</title>
      <title>Test Engineer</title>
   </also_called>
   <what_they_do>Research, design, develop, test, or supervise the manufacturing and installation of electrical equipment, components, or systems for commercial, industrial, military, or scientific use.</what_they_do>
   <on_the_job>
      <task>Operate computer-assisted engineering or design software or equipment to perform engineering tasks.</task>
      <task>Prepare technical drawings, specifications of electrical systems, or topographical maps to ensure that installation and operations conform to standards and customer requirements.</task>
      <task>Confer with engineers, customers, or others to discuss existing or potential engineering projects or products.</task>
   </on_the_job>
   <career_video />
   <resources>
      <resource href="https://services.onetcenter.org/v1.7/ws/mnm/careers/17-2071.00/knowledge">
         <title>Knowledge</title>
      </resource>
      ...
   </resources>
</career>

This response covers a single career in more detail. Not all elements are present, depending on the data available in the career. The following elements may be present:

  • code - the O*NET-SOC code for the career. See the O*NET-SOC Taxonomy page for more information.
  • title - the career name shown in My Next Move.
  • tags - indicates whether the career is considered a Bright Outlook or Green occupation, and whether Registered Apprenticeships are available for this career.
  • also_called - a sample of job titles reported during the O*NET data collection process. Job titles are not available for all careers.
  • what_they_do - the O*NET-SOC description of the career.
  • on_the_job - a sample of tasks performed by workers in the career.
  • career_video - careers with this element have a related video describing the work performed and skills needed. The videos displayed on My Next Move are developed and maintained by CareerOneStop external site. Visit CareerOneStop external site directly for information and options for incorporating the videos.
  • resources - links to each of the more detailed career web services, as explained below. Some resources are not available for all careers.

Knowledge

https://services.onetcenter.org/v1.7/ws/mnm/careers/[O*NET-SOC Code]/knowledge
<knowledge code="17-2051.00">
   <group>
      <title id="2.C.3">Engineering and Technology</title>
      <element id="2.C.3.b">product and service development</element>
      <element id="2.C.3.d">building and construction</element>
   </group>
   <group>
      <title id="2.C.4">Math and Science</title>
      <element id="2.C.4.a">arithmetic, algebra, geometry, calculus, or statistics</element>
      <element id="2.C.4.b">physics</element>
   </group>
   ...
</knowledge>

This response returns the key knowledge areas for a career. For careers with knowledge data collected by the O*NET program, one or more group elements will be returned.

Each group element contains exactly one title child, which is shown in colored bold text in My Next Move. The id attribute indicates the corresponding element ID within the O*NET Content Model. Subsequent element children are shown as list items within My Next Move, and also contain an id attribute indicating the corresponding Content Model element.

Skills

https://services.onetcenter.org/v1.7/ws/mnm/careers/[O*NET-SOC Code]/skills
<skills code="17-2051.00">
   <group>
      <title id="2.A">Basic Skills</title>
      <element id="2.A.1.a">reading work related information</element>
      <element id="2.A.2.a">thinking about the pros and cons of different ways to solve a problem</element>
   </group>
   <group>
      <title id="2.B.2">Problem Solving</title>
      <element id="2.B.2.i">noticing a problem and figuring out the best way to solve it</element>
   </group>
   ...
</skills>

This response returns the key skills for a career. For careers with skills data collected by the O*NET program, one or more group elements will be returned.

Each group element contains exactly one title child, which is shown in colored bold text in My Next Move. The id attribute indicates the corresponding element ID within the O*NET Content Model. Subsequent element children are shown as list items within My Next Move, and also contain an id attribute indicating the corresponding Content Model element.

Abilities

https://services.onetcenter.org/v1.7/ws/mnm/careers/[O*NET-SOC Code]/abilities
<abilities code="17-2051.00">
   <group>
      <title id="1.A.1.a">Verbal</title>
      <element id="1.A.1.a.3">communicate by speaking</element>
      <element id="1.A.1.a.1">listen and understand what people say</element>
   </group>
   <group>
      <title id="1.A.1.b">Ideas and Logic</title>
      <element id="1.A.1.b.5">make general rules or come up with answers from lots of detailed information</element>
      <element id="1.A.1.b.3">notice when problems happen</element>
   </group>
   ...
</abilities>

This response returns the key abilities for a career. For careers with skills data collected by the O*NET program, one or more group elements will be returned.

Each group element contains exactly one title child, which is shown in colored bold text in My Next Move. The id attribute indicates the corresponding element ID within the O*NET Content Model. Subsequent element children are shown as list items within My Next Move, and also contain an id attribute indicating the corresponding Content Model element.

Personality

https://services.onetcenter.org/v1.7/ws/mnm/careers/[O*NET-SOC Code]/personality
<personality code="17-2051.00">
   <top_interest id="1.B.1.a">
      <title>Realistic</title>
      <description>People interested in this work like activities that include practical, hands-on problems and solutions.</description>
   </top_interest>
   <work_styles>
      <element id="1.C.5.c">Integrity</element>
      <element id="1.C.5.a">Dependability</element>
      ...
   </work_styles>
</personality>

This response returns the top interest and key work styles for a career.

For careers with Interests ratings collected by the O*NET program, the top_interest element will contain the O*NET Content Model ID and title of the first interest high-point. A short description is also included. The Interest Profiler results service provides an expanded description of each interest area.

For careers with work styles data collected by the O*NET program, the work_styles element will contain one or more element elements. The id attribute indicates the corresponding element ID within the O*NET Content Model.

Technology

https://services.onetcenter.org/v1.7/ws/mnm/careers/[O*NET-SOC Code]/technology
<technology code="17-2051.00">
   <category unspsc="43232604">
      <title hot_technology="192">Computer aided design CAD software</title>
      <example hot_technology="19">Autodesk AutoCAD</example>
      <example hot_technology="95">Dassault Systemes CATIA</example>
   </category>
   <category unspsc="43232605">
      <title>Analytical or scientific software</title>
      <example hot_technology="97">Minitab</example>
      <example hot_technology="50">The MathWorks MATLAB</example>
   </category>
   ...
</technology>

This response returns selected examples of the software used in a career. For occupations with technology examples collected by the O*NET Tools and Technology project, one or more category elements will be returned.

Each category element includes a unspsc attribute, which indicates the UNSPSC external site commodity under which the examples are grouped. The element contains exactly one title child, which corresponds to the UNSPSC commodity title. Zero or more example elements follow, indicating more specific products or types of software used by workers in the occupation.

Any examples or categories classified as “hot technologies” are identified with a hot_technology attribute on the example or title element. The value is an ID which can be passed to the Hot Technology details service (part of the O*NET OnLine services). My Next Move marks hot technologies with a fire icon Hot Technology; developers can download this icon in multiple sizes from the Resource Center Graphics section.

Education

https://services.onetcenter.org/v1.7/ws/mnm/careers/[O*NET-SOC Code]/education
<education code="53-7031.00">
   <job_zone>2</job_zone>
   <education_usually_needed>
      <category>high school diploma/GED</category>
   </education_usually_needed>
   <apprenticeships>
      <title rapids="0117">Dredge Operator</title>
   </apprenticeships>
</education>

This response returns education and apprenticeship data for the requested career.

The job_zone element describes the amount of job preparation needed. When present, the career is in one of five Job Zones, which are groups of careers that need the same level of experience, education, and training. The element content is a number between 1 and 5. The Interest Profiler Job Zones resource provides information about each Job Zone.

The education_usually_needed element provides the most commonly reported level(s) of education required for jobs in the career. One or more category elements are returned:

  • no high school diploma/GED
  • high school diploma/GED
  • certificate after high school
  • some college
  • associate's degree
  • bachelor's degree
  • certificate after college
  • master's degree
  • certificate after master's
  • professional degree
  • doctoral degree
  • post-doctoral training

The apprenticeships element lists the title and RAPIDS external site code for each related apprenticeship program registered with the Office of Apprenticeship external site.

Job Outlook

https://services.onetcenter.org/v1.7/ws/mnm/careers/[O*NET-SOC Code]/job_outlook
<job_outlook code="49-9021.02">
   <outlook>
      <description>New job opportunities are very likely in the future.</description>
      <category>Bright</category>
   </outlook>
   <bright_outlook>
      <description>This career will grow rapidly in the next few years.</description>
      <category>Grow Rapidly</category>
   </bright_outlook>
   <salary soc_code="49-9021">
      <annual_median>47080</annual_median>
   </salary>
   <green>
      <description>Green jobs will increase the demand for this type of work.</description>
      <category>Increased Demand</category>
   </green>
</job_outlook>

This response returns information related to job opportunities and employment for the career.

The outlook element indicates whether job opportunities are likely in the future. One of three category values is returned:

  • Bright - the career meets one or more Bright Outlook criteria
  • Average - the career does not meet Bright Outlook criteria, but is projected to have at least a 5% increase in employment over 2016-2026
  • Below Average - the career does not meet Bright or Average criteria.

My Next Move illustrates each outlook category with a graphic, as shown below. Developers can download multiple sizes and formats from the O*NET Graphics page.

Bright   Average   Below Average

The bright_outlook element is present if the career meets Bright Outlook criteria. One or more category elements are returned to indicate the criteria matched:

  • Grow Rapidly - the career will grow rapidly in the next few years
  • Openings - the career will have large numbers of openings
  • New & Emerging - this is a new and emerging career

The salary element provides annual median wages, from the BLS Occupational Employment Statistics external site wage estimates. The soc_code attribute indicates the SOC code for which the estimate was published.

The green element is present when the career has been identified as part of the green economy. One of three category values is returned:

  • Increased Demand - the green economy will increase the demand for this type of work
  • Changed Work - the green economy will change the work and skills needed on the job
  • New & Emerging - the career represents a new type of work created by the green economy

My Next Move illustrates each Green occupation with a graphic, as shown below. Developers can download multiple sizes and formats from the O*NET Graphics page.

Green

Check Out My State

https://services.onetcenter.org/v1.7/ws/mnm/careers/[O*NET-SOC Code]/check_out_my_state
<check_out_my_state code="17-1011.00">
   <map href="https://services.onetcenter.org/v1.7/ws/mnm/state-maps/17-1011.gif" width="600" height="340" />
   <legend href="https://services.onetcenter.org/v1.7/ws/mnm/state-maps/legend.gif" width="230" height="85" />
   <above_average>
      <state postal_code="DC" location_quotient="3.86">District of Columbia</state>
      <state postal_code="NY" location_quotient="1.91">New York</state>
      ...
   </above_average>
   <average>
      <state postal_code="IL" location_quotient="1.20">Illinois</state>
      <state postal_code="MA" location_quotient="1.19">Massachusetts</state>
      ...
   </average>
   <below_average>
      <state postal_code="ND" location_quotient="0.79">North Dakota</state>
      <state postal_code="AL" location_quotient="0.78">Alabama</state>
      ...
   </below_average>
</check_out_my_state>

This response returns information to compare job opportunities for this career by state. The data is based on location quotient info published by the BLS Occupational Employment Statistics external site program.

The map element provides a link to an image, visually representing states with above average or below average opportunities. The legend element provides a link to a separate image explaining the color scheme.

Depending on the available data, additional elements list specific states in each of three categories of opportunity:

  • above_average - these states have an above average share of this career in their workforce (location quotient of 1.25 or higher).
  • average - these states have an average share of this career (location quotient between 0.80 and 1.25).
  • below_average - these states have a below average share of this career (location quotient lower than 0.80).

In each category, states are sorted by location quotient: the states with the highest share are listed first. Each state element includes the two-letter abbreviation and the numeric location quotient.

Explore More

https://services.onetcenter.org/v1.7/ws/mnm/careers/[O*NET-SOC Code]/explore_more
<explore_more code="17-2051.00">
   <careers>
      <career href="https://services.onetcenter.org/v1.7/ws/mnm/careers/17-2021.00/">
         <code>17-2021.00</code>
         <title>Agricultural Engineers</title>
         <tags bright_outlook="false" green="false" apprenticeship="false" />
      </career>
      <career href="https://services.onetcenter.org/v1.7/ws/mnm/careers/15-1199.02/">
         <code>15-1199.02</code>
         <title>Computer Systems Engineers/Architects</title>
         <tags bright_outlook="false" green="false" apprenticeship="false" />
      </career>
      ...
   </careers>
   <industries soc_code="17-2051">
      <industry href="https://services.onetcenter.org/v1.7/ws/mnm/browse/54" percent_employed="54">
         <code>54</code>
         <title>Professional, Science, &amp; Technical</title>
      </industry>
      ...
   </industries>
</explore_more>

This response returns a list of related careers and industries that may be of interest to career explorers or workers looking to transition to another career.

The careers element contains careers with similar characteristics to the requested career, as provided by the O*NET Related Occupations program.

The industries element contains industries that employ at least 10% of workers in the requested occupation. Industry employment data is reported by BLS Employment Projections external site. If industry data is available, the soc_code attribute indicates the SOC code under which industry employment was published.

Where do they work?

https://services.onetcenter.org/v1.7/ws/mnm/careers/[O*NET-SOC Code]/where_do_they_work
<where_do_they_work code="17-2051.00">
   <industry href="https://services.onetcenter.org/v1.7/ws/mnm/browse/54" percent_employed="54">
      <code>54</code>
      <title>Professional, Science, &amp; Technical</title>
   </industry>
   <industry href="https://services.onetcenter.org/v1.7/ws/mnm/browse/93" percent_employed="25">
      <code>93</code>
      <title>Government</title>
   </industry>
   ...
</where_do_they_work>

This response returns a list of industries that employ at least 10% of workers in the requested career. Industry employment data is reported by BLS Employment Projections external site. In My Next Move, these industries are shown in the "Where do they work?" popup when browsing careers by industry.

Full career report

https://services.onetcenter.org/v1.7/ws/mnm/careers/[O*NET-SOC Code]/report
<report code="17-2051.00">
   <career> ... </career>
   <knowledge> ... </knowledge>
   <skills> ... </skills>
   <abilities> ... </abilities>
   <personality> ... </personality>
   <technology> ... </technology>
   <education> ... </education>
   <job_outlook> ... </job_outlook>
   <check_out_my_state> ... </check_out_my_state>
   <explore_more> ... </explore_more>
   <where_do_they_work> ... </where_do_they_work>
</report>

This response returns information from all of the career-specific services described above, including the overview. Clients interested in a variety of career data may use this call to retrieve information in fewer requests.

Back to top