List All Careers

get

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

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, nocs. The category, pathway, and nocs keys cannot be used together. The fields key is always required as there is no default return object.

Path Params

level

string

required

Type of geographic regional division.

geoId

string

required

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

Query Params

category?

number

Filter careers by one of the categories.

fields?

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, median-earnings, national-lq, noc-id, pathways, percent-female, percent-male, singular-title, title, title-slug, typical-ed-level.

fields?*

pathway?

string

Filter careers by one of the pathways.

nocs?

array of strings

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

nocs?

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.

Responses

Language

Credentials

OAuth2

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200

400

404