Employment at Wage

post

https://earnings.emsicloud.com/v1/us/{datarun}/employment_at_wage

This endpoint produces estimates of the number of jobs currently at or below the specified wages.

This allows the client to answer questions such as "how many forklift drivers are willing to work for 12.50 an hour?"

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

datarun

string

enum

required

Specify datarun version

Allowed:

Body Params

areas

array of strings

required

One or more FIPS codes (if geotype is fips) or ZIP codes (if geotype is zip).

areas*

classes

array of integers

required

One or more class of worker codes.

classes*

geotype

string

enum

required

length ≥ 1

Either fips for the FIPS geography taxonomy (nation/state/county) or zip for ZIP codes

Allowed:

occupations

array of strings

One or more codes from the SOC occupation taxonomy. Defaults to all occupations if not provided

occupations

wage_per

string

enum

Defaults to hourly

Specify wage type.

Allowed:

wages

array of strings

required

Array of wages to estimate employment at. Values should be numeric though represented as strings and in sorted order, low to high.

wages*

year

integer

Earnings year to aggregate; must be one of the available years for the selected datarun. Defaults to latest year

Headers

string

enum

Defaults to application/json

Generated from available response content types

Allowed:

Responses

401

The bearer token is missing, expired, or invalid. The response has no body.

403

The bearer token is valid but does not carry the occearn scope. The response has no body.

503

The coprocessors that carry out the calculation are not all running, so the service cannot answer the request. The response has no body. GET /status reports the same condition.

Language

Credentials

OAuth2

Loading…

Response

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

application/json

text/plain

200Estimated employment at or below each requested wage.

400The request body is missing or failed validation. A body that could not be read at all produces an empty response; a body whose areas, occupations, or classes are not present in the datarun produces a JSON array of messages.

404The requested datarun is not one of the dataruns the service has loaded.

500The request was accepted but the service could not complete it.