List All LOT Careers by POST

post

https://cc.emsiservices.com/lot/{level}

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 to fit into a query string. Returns a list of all careers with data corresponding to the geographical area(s) specified. 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.

Path Params

level

string

required

Type of geographic regional division.

Query Params

category?

number

Filter careers by one of the categories.

lotFields?

array of strings

required

Individual career fields used to filter the response body. The response can be any combination of the fields on the careers object. Fields should be dasherised and separated by comma. Valid field values are age, annual-earnings, annual-openings, categories, core-tasks, employment, employment-current, hourly-earnings, lot-id, median-earnings, national-lq, pathways, percent-female, percent-male, singular-title, standard-description, standard-id, standard-title, title, title-slug, typical-ed-level.

lotFields?*

pathway?

string

Filter careers by one of the pathways.

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?

offset?

integer

the number of results to skip over. For instance, ?offset=5 means the first 5 results would be omitted.

limit?

integer

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

Body Params

geoids

array

required

The actual identifier for that geography (e.g. a CSD: 35 31 030).*

Responses

200

400

404