Status Page
API Reference

List All LOT Careers by POST

post
https://example.com/lot/

This query is identical to the GET query above except that the geoids are to be POSTed in a json array rather than appending them to the querystring. This should be used if you have too many areas and/or LOT ids to fit into a query string. Returns a list of all careers with data corresponding to the geographical area(s) specified. The lot-ids URL parameter cannot be used if career-codes are present in the request body. There are four query keys that you can pass: category, pathway, fields, lot-ids. 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.

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, knowledge, lay-titles, median-earnings, mocs, national-lq, pathways, percent-female, percent-male, plural-short-title, short-title, similar-occs, singular-title, skills, soc-id, soc-title, standard-description, standard-id, standard-title, title, title-slug, typical-ed-level.

fields*
lot-ids
array of strings

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

lot-ids
number

filter careers by one of 36 categories.

string

filter careers by one of 170 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