Reference Manual (API Version 1.9)
Check Out My State
https://services.onetcenter.org/v1.9/ws/mpp/careers/[O*NET-SOC Code]/check_out_my_state
JSON
XML
{
"code" : "17-1011.00",
"map" : {
"href" : "https://services.onetcenter.org/v1.9/ws/mpp/state-maps/17-1011.gif",
"width" : 600,
"height" : 340
},
"legend" : {
"href" : "https://services.onetcenter.org/v1.9/ws/mpp/state-maps/legend_es.gif",
"width" : 330,
"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"
},
...
]
}
}
"code" : "17-1011.00",
"map" : {
"href" : "https://services.onetcenter.org/v1.9/ws/mpp/state-maps/17-1011.gif",
"width" : 600,
"height" : 340
},
"legend" : {
"href" : "https://services.onetcenter.org/v1.9/ws/mpp/state-maps/legend_es.gif",
"width" : 330,
"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"
},
...
]
}
}
JSON
XML
<check_out_my_state code="17-1011.00">
<map href="https://services.onetcenter.org/v1.9/ws/mpp/state-maps/17-1011.gif" width="600" height="340" />
<legend href="https://services.onetcenter.org/v1.9/ws/mpp/state-maps/legend_es.gif" width="330" height="85" />
<above_average>
<state postal_code="DC" location_quotient="3.6">District of Columbia</state>
<state postal_code="MA" location_quotient="1.81">Massachusetts</state>
...
</above_average>
<average>
<state postal_code="IL" location_quotient="1.24">Illinois</state>
<state postal_code="HI" location_quotient="1.23">Hawaii</state>
...
</average>
<below_average>
<state postal_code="FL" location_quotient="0.77">Florida</state>
<state postal_code="OK" location_quotient="0.76">Oklahoma</state>
...
</below_average>
</check_out_my_state>
<map href="https://services.onetcenter.org/v1.9/ws/mpp/state-maps/17-1011.gif" width="600" height="340" />
<legend href="https://services.onetcenter.org/v1.9/ws/mpp/state-maps/legend_es.gif" width="330" height="85" />
<above_average>
<state postal_code="DC" location_quotient="3.6">District of Columbia</state>
<state postal_code="MA" location_quotient="1.81">Massachusetts</state>
...
</above_average>
<average>
<state postal_code="IL" location_quotient="1.24">Illinois</state>
<state postal_code="HI" location_quotient="1.23">Hawaii</state>
...
</average>
<below_average>
<state postal_code="FL" location_quotient="0.77">Florida</state>
<state postal_code="OK" location_quotient="0.76">Oklahoma</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 and Wage Statistics 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.