Status Page
API Reference

List All Careers

get
https://example.com//

Returns a list of all careers with data corresponding to the geographical area(s) specified. There are five query keys that you can pass: category, pathway, moc, fields, onets. The category, pathway, moc and onets keys cannot be used together. The fields key is always required as there is no default return object.

Path Params
string
required

type of geographic regional division. Valid level options are nation, county, state, zip, and msa.

string
required

geographical identifier associated with a specific area. Can be a single id, or comma-delimited string of ids

Query Params
fields
array of strings
required

A comma-separated array of individual career fields.
Must be one or more of abilities, age, annual-earnings, annual-openings, categories, core-tasks, description, education-attainment-levels, employment, employment-current, hourly-earnings, humanized-title, knowledge, lay-titles, median-earnings, mocs, national-lq, onet-id, pathways, percent-female, percent-male, plural-short-title, short-title, similar-occs, singular-title, skills, soc-id, soc-title, title, title-slug, typical-ed-level.

fields*
onets
array of strings

a subset of specific O*NET IDs to filter the careers list by. Unrecognized ONET IDs will be skipped. If no ONET IDs are recognized, an empty array is returned.

onets
number

filter careers by one of the categories.

string

filter careers by one of the pathways.

string

a modified moc code that includes the military branch and status as a prefix.

string

Parameter used to indicate which datarun version to query during transitionary periods when multiple dataruns are being supported. Currently, the only datarun supported is 2025_1.

integer

(for pagination); The number of results to skip over. For instance, ?offset=5 means the first 5 results would be omitted.

integer

(for pagination); The total number of results to return. For instance, ?limit=10 means the result set is limited to 10 results. Used in conjunction with offset, you can slice the result set, e.g. ?offset=20&limit=10 would give you results 21-31.

Responses

Updated 9 months ago

Language
Credentials
OAuth2
Missing 1 required scope
Response 
Click Try It! to start a request and see the response here! Or choose an example:
application/json
Updated 9 months ago