Status Page
API Reference

List All Careers by POST

post
https://example.com/

This query is identical to the GET query above except that you POST the geoids in a json array rather than appending them to the querystring. This should only be used if you have too many areas and/or ONET codes to fit into a query string. 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.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

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

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.

Body Params
geoids
object
required
career-codes
object
Responses

Updated 9 months ago

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

Updated 9 months ago