GET/v1/compliance/salary-bands/{country}

Get recommended salary bands for a job posting (EU compliance)

Return three compliant salary band options — `recommended`, `narrow`, and `wide` — for a job title in a specific EU country, based on statistical modelling of Eurostat SES percentile data. Use this when an employer needs to fill in a pay transparency posting ('What range should I put in my job advert for a software developer in Germany?') and wants a defensible band anchored to official benchmarks. **How the bands are built:** a log-normal distribution is fit to the p10, p25, p50, p75, p90 points from Eurostat SES for the matched ISCO major group in the target country. The three bands are derived from different percentile windows (e.g. `narrow` = p25–p75, `wide` = p10–p90). **Response:** the three bands, the national minimum wage for reference, the methodology note, and a legal disclaimer. Each band includes a human-readable `description` explaining the statistical interpretation. Source: Eurostat SES, national statistics offices, EU Directive 2023/970. Required scope: `compliance:read` (Pro tier or higher).

Authentication

Requires API key via X-API-Key header.

Parameters

Name	In	Type	Required	Description
country	path	string	required
job_title	query	string	required	Job title (e.g., 'software developer')

Example request

curl

curl -X GET \
  "https://salary.wageapi.com/api/v1/compliance/salary-bands/DE?job_title=%3Cjob_title%3E" \
  -H "X-API-Key: YOUR_API_KEY"

Responses

200Successful Response

country_codestringrequired

country_namestringrequired

job_titlestringrequired

matched_iscostringrequired

matched_titlestringrequired

bandsarray<ComplianceSalaryBand>required

array of ComplianceSalaryBand

labelstringrequired

min_salarynumberrequired

max_salarynumberrequired

descriptionstringrequired

minimum_wageanyrequired

one of:

option 1:

monthly_euranyrequired

one of:

option 1:

number

option 2:

null

monthly_ppsanyrequired

one of:

option 1:

number

option 2:

null

yearintegerrequired

semesteranyoptional

one of:

option 1:

integer

option 2:

null

option 2:

null

currencystringoptional

default "EUR"

data_sourcestringrequired

data_yearintegerrequired

methodology_notestringrequired

disclaimerstringoptional

default "Salary bands are statistical estimates based on Eurostat SES data and log-normal distribution modelling. They do not constitute legal advice. Consult a qualified employment lawyer for compliance decisions."

401Missing or invalid API key.

errorErrorDetailrequired

Structured error payload returned by all Aethar APIs. Mirrors the shape produced by aethar_auth.exception_handlers so the OpenAPI spec accurately describes real error bodies for documentation readers and MCP clients.

codestringrequired

Machine-readable error code (e.g. INVALID_API_KEY)

messagestringrequired

Human-readable error message

statusintegerrequired

HTTP status code

request_idstringrequired

Request identifier — include in support tickets

suggestionanyoptional

Actionable hint on how to resolve the error

one of:

option 1:

string

option 2:

null

doc_urlanyoptional

Link to full documentation for this error code

one of:

option 1:

string

option 2:

null

fieldanyoptional

Field that caused the error (if applicable)

one of:

option 1:

string

option 2:

null

errorsanyoptional

Per-field validation errors (only for 422 VALIDATION_ERROR responses)

one of:

option 1:

array of object

object

option 2:

null

403API key lacks the required scope for this endpoint.

errorErrorDetailrequired

codestringrequired

Machine-readable error code (e.g. INVALID_API_KEY)

messagestringrequired

Human-readable error message

statusintegerrequired

HTTP status code

request_idstringrequired

Request identifier — include in support tickets

suggestionanyoptional

Actionable hint on how to resolve the error

one of:

option 1:

string

option 2:

null

doc_urlanyoptional

Link to full documentation for this error code

one of:

option 1:

string

option 2:

null

fieldanyoptional

Field that caused the error (if applicable)

one of:

option 1:

string

option 2:

null

errorsanyoptional

Per-field validation errors (only for 422 VALIDATION_ERROR responses)

one of:

option 1:

array of object

object

option 2:

null

404No Eurostat SES benchmark for the matched ISCO code and country.

errorErrorDetailrequired

codestringrequired

Machine-readable error code (e.g. INVALID_API_KEY)

messagestringrequired

Human-readable error message

statusintegerrequired

HTTP status code

request_idstringrequired

Request identifier — include in support tickets

suggestionanyoptional

Actionable hint on how to resolve the error

one of:

option 1:

string

option 2:

null

doc_urlanyoptional

Link to full documentation for this error code

one of:

option 1:

string

option 2:

null

fieldanyoptional

Field that caused the error (if applicable)

one of:

option 1:

string

option 2:

null

errorsanyoptional

Per-field validation errors (only for 422 VALIDATION_ERROR responses)

one of:

option 1:

array of object

object

option 2:

null

422Request validation failed (bad JSON shape, missing required fields, etc.).

errorErrorDetailrequired

codestringrequired

Machine-readable error code (e.g. INVALID_API_KEY)

messagestringrequired

Human-readable error message

statusintegerrequired

HTTP status code

request_idstringrequired

Request identifier — include in support tickets

suggestionanyoptional

Actionable hint on how to resolve the error

one of:

option 1:

string

option 2:

null

doc_urlanyoptional

Link to full documentation for this error code

one of:

option 1:

string

option 2:

null

fieldanyoptional

Field that caused the error (if applicable)

one of:

option 1:

string

option 2:

null

errorsanyoptional

Per-field validation errors (only for 422 VALIDATION_ERROR responses)

one of:

option 1:

array of object

object

option 2:

null

429Daily rate limit exceeded for this API key.

errorErrorDetailrequired

codestringrequired

Machine-readable error code (e.g. INVALID_API_KEY)

messagestringrequired

Human-readable error message

statusintegerrequired

HTTP status code

request_idstringrequired

Request identifier — include in support tickets

suggestionanyoptional

Actionable hint on how to resolve the error

one of:

option 1:

string

option 2:

null

doc_urlanyoptional

Link to full documentation for this error code

one of:

option 1:

string

option 2:

null

fieldanyoptional

Field that caused the error (if applicable)

one of:

option 1:

string

option 2:

null

errorsanyoptional

Per-field validation errors (only for 422 VALIDATION_ERROR responses)

one of:

option 1:

array of object

object

option 2:

null

500Unexpected server error. Includes a request_id for support.

errorErrorDetailrequired

codestringrequired

Machine-readable error code (e.g. INVALID_API_KEY)

messagestringrequired

Human-readable error message

statusintegerrequired

HTTP status code

request_idstringrequired

Request identifier — include in support tickets

suggestionanyoptional

Actionable hint on how to resolve the error

one of:

option 1:

string

option 2:

null

doc_urlanyoptional

Link to full documentation for this error code

one of:

option 1:

string

option 2:

null

fieldanyoptional

Field that caused the error (if applicable)

one of:

option 1:

string

option 2:

null

errorsanyoptional

Per-field validation errors (only for 422 VALIDATION_ERROR responses)

one of:

option 1:

array of object

object

option 2:

null

Try this endpoint

Create a free Aethar account and generate an API key in 2 minutes.

Create free account →