Skip to main content
GET
Observed salary range

Authorizations

Authorization
string
header
required

Clair dashboard key. Create keys at https://clair.im/dashboard/api-keys.

Query Parameters

country
string

Optional ISO 3166-1 alpha-2 country filter.

Pattern: ^[A-Za-z]{2}$
workplace_type
enum<string>

Optional normalized workplace filter.

Available options:
remote,
hybrid,
onsite
seniority
enum<string>

Optional normalized seniority filter.

Available options:
intern,
entry,
mid,
senior,
staff,
principal,
executive
role
string

Canonical role ID or name from /v1/taxonomy/roles.

Required string length: 1 - 160
skill
string

Canonical skill ID or name from /v1/taxonomy/skills.

Required string length: 1 - 160
currency
string
default:USD

ISO 4217 currency for the salary slice. Defaults to USD. Currencies are never converted.

Pattern: ^[A-Za-z]{3}$
salary_interval
enum<string>
default:year

Pay interval for the salary slice. Defaults to year. Hourly and yearly figures are never mixed.

Available options:
year,
hour,
month,
week,
day

Response

Observed compensation statistics for the selected market slice.

updated_at
string<date-time> | null
required

Latest verification time represented by the aggregation.

filters
object
required

Normalized filters applied to the aggregation.

currency
string
required
interval
enum<string>
required
Available options:
year,
hour,
month,
week,
day
postings_analyzed
integer
required
salary_postings
integer
required
min
number | null
required
max
number | null
required
average
number | null
required
median
number | null
required