Skip navigation

Reference Manual (API Version 1.9)

Check Out My State

https://services.onetcenter.org/v1.9/ws/veterans/careers/[O*NET-SOC Code]/check_out_my_state
JSON XML
{
   "code" : "17-1011.00",
   "map" : {
      "href" : "https://services.onetcenter.org/v1.9/ws/veterans/state-maps/17-1011.gif",
      "width" : 600,
      "height" : 340
   },
   "legend" : {
      "href" : "https://services.onetcenter.org/v1.9/ws/veterans/state-maps/legend.gif",
      "width" : 230,
      "height" : 85
   },
   "above_average" : {
      "state" : [
         {
            "postal_code" : "DC",
            "location_quotient" : 3.6,
            "name" : "District of Columbia"
         },
         {
            "postal_code" : "MA",
            "location_quotient" : 1.81,
            "name" : "Massachusetts"
         },
         ...
      ]
   },
   "average" : {
      "state" : [
         {
            "postal_code" : "IL",
            "location_quotient" : 1.24,
            "name" : "Illinois"
         },
         {
            "postal_code" : "HI",
            "location_quotient" : 1.23,
            "name" : "Hawaii"
         },
         ...
      ]
   },
   "below_average" : {
      "state" : [
         {
            "postal_code" : "FL",
            "location_quotient" : 0.77,
            "name" : "Florida"
         },
         {
            "postal_code" : "OK",
            "location_quotient" : 0.76,
            "name" : "Oklahoma"
         },
         ...
      ]
   }
}

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 and Wage 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.

In this section