Skip navigation

Reference Manual (API Version 1.8)

Find careers like your military job

https://services.onetcenter.org/v1.8/ws/veterans/military?keyword=[title or code]
JSON XML
{
   "keyword" : "11B",
   "branch" : "all",
   "start" : 1,
   "end" : 33,
   "total" : 33,
   "military_matches" : {
      "match" : [
         {
            "branch" : "army",
            "active" : true,
            "code" : "11B",
            "title" : "Infantryman (Enlisted)",
            "external_info" : [
               {
                  "href" : "https://www.careersinthemilitary.com/career-detail/0073.00",
                  "title" : "Careers in the Military"
               }
            ]
         }
      ]
   },
   "career" : [
      {
         "href" : "https://services.onetcenter.org/v1.8/ws/veterans/careers/47-2061.00/",
         "match_type" : "some_duties",
         "code" : "47-2061.00",
         "title" : "Construction Laborers",
         "tags" : {
            "bright_outlook" : true,
            "green" : true,
            "apprenticeship" : true
         },
         "military_jobs" : {
            "air_force" : true,
            "army" : true,
            "coast_guard" : false,
            "marine_corps" : true,
            "navy" : true
         },
         "preparation_needed" : "First term",
         "pay_grade" : "E1"
      },
      {
         "href" : "https://services.onetcenter.org/v1.8/ws/veterans/careers/33-3012.00/",
         "match_type" : "some_duties",
         "code" : "33-3012.00",
         "title" : "Correctional Officers & Jailers",
         "tags" : {
            "bright_outlook" : false,
            "green" : false,
            "apprenticeship" : true
         },
         "military_jobs" : {
            "air_force" : true,
            "army" : true,
            "coast_guard" : false,
            "marine_corps" : true,
            "navy" : true
         },
         "preparation_needed" : "First term plus prep",
         "pay_grade" : "E4"
      },
      ...
   ]
}

This response returns My Next Move for Veterans careers similar to a military code or title. Closest matches are returned first.

An optional parameter, branch, can be added to limit searches to a single service branch. The branch codes are:

  • all - all branches (default)
  • air_force - Air Force (AFSC)
  • army - Army (MOS)
  • coast_guard - Coast Guard (Ratings)
  • marine_corps - Marine Corps (MOS)
  • navy - Navy (Ratings)

If the search query exactly matches any military code or title, the matched military occupations are returned in the military_matches element, before the civilian career matches. Some matched military occupations include an external_info element which links to more information from Careers in the Military external site.

Each career match contains a match_type attribute indicating the reason the match was included:

  • most_duties - tasks in this career match most duties of the matched military job.
  • some_duties - tasks in this career match some duties of the matched military job or a specialty.
  • crosswalk - this career is crosswalked to one or more matched military jobs, but the degree of similarity is not available.
  • keyword - this career did not match based on a military job search, but is relevant to one or more key words in the search query. These results are only returned when few or no crosswalk matches are available.

Civilian careers with a match type of most_duties or some_duties also include additional information about the match. The pay_grade element indicates the minimum military pay grade at which a service member would usually qualify for the listed career. The preparation_needed element indicates the amount of preparation needed to transition:

  • First term - service members can transition to this career within their first term (4-6 years) of service.
  • First term plus prep - service members can possibly transition to this career within their first term (4-6 years) of service, but may need to get state licensure or additional education, training, or experience.
  • Long term - service members probably cannot transition to this career within their first term (4-6 years) of service.

To download crosswalk data used in the military search, see the Crosswalk Files page at the O*NET Resource Center. Developers might also be interested in the following technical report:

In this section