v1

latestOpenAPI 3.1.02026-07-242892032.8 MB

List All LOT Careers by POST

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.

post/lot/{level}

Query parameters

fieldsstring[] required

A comma-separated array of individual career fields.<br>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.

lot-idsstring[]

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.

categorynumber

filter careers by one of 36 categories.

pathwaystring

filter careers by one of 170 pathways.

mocstring

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

datarunstring

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.

offsetinteger

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

limitinteger

(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.

Request body

Response