Documentation / Basics

Coverage | Salary Data API

Coverage

For each country: its tables, series and figures, the years they reach and the breakdowns it publishes.

GEThttps://api.salarydataapi.com/v1/coverage?region=europe

Try it

Runs against the live API with your key.
curl "https://api.salarydataapi.com/v1/coverage?region=europe" \
  -H "Authorization: Bearer YOUR_KEY"

Parameters

NameTypeWhat it is
regionstringOnly one region
europeasiaamericasmiddle-eastafricaoceania
pageintegerThe page, from 1. Default 1.
per_pageintegerItems a page, at most 200. Default 50.
cursorstringFrom next_cursor in the last answer; page wins when both are sent

Returns

A list in data, each item with these fields, and the paging in meta.

FieldTypeWhat it holds
countrystringTwo-letter country code, lower case
namestringThe country in English
regionstringEurope, Asia, Americas, Middle East, Africa or Oceania
currencystringThe currency its figures are in today (ISO 4217)
tablesintegerTables
seriesintegerPay series
figuresintegerFigures
first_yearyearFirst year
last_periodperiodLatest period
breakdownsarrayoccupation, sex, age, education, area, industry: the ones it publishes

Example answer

A real answer from today's figures, the first three items, with an Analyst key.

200GET /v1/coverage?region=europe
{
    "data": [
        {
            "country": "at",
            "name": "Austria",
            "region": "Europe",
            "currency": "EUR",
            "tables": 5,
            "series": 1308,
            "figures": 1043305,
            "first_year": 2008,
            "last_period": "2023",
            "breakdowns": [
                "sex",
                "age",
                "area"
            ]
        },
        {
            "country": "be",
            "name": "Belgium",
            "region": "Europe",
            "currency": "EUR",
            "tables": 3,
            "series": 7,
            "figures": 127,
            "first_year": 1999,
            "last_period": "2022",
            "breakdowns": [
                "area"
            ]
        },
        {
            "country": "hr",
            "name": "Croatia",
            "region": "Europe",
            "currency": "EUR",
            "tables": 8,
            "series": 32904,
            "figures": 50102,
            "first_year": 2025,
            "last_period": "2026",
            "breakdowns": [
                "sex"
            ]
        }
    ],
    "meta": {
        "count": 3,
        "next_cursor": "YzM",
        "page": 1,
        "per_page": 3,
        "total": 24,
        "total_pages": 8,
        "next_page": 2,
        "prev_page": null,
        "plan": "analyst"
    }
}

Errors