Pay figures | Salary Data API
Pay figuresHow a figure is named, what each statistic means, and how /v1/pay picks the series that answers you.
Every figure has a name in one shape: pay.<statistic>.<period>, with .net at the end for pay after tax.
| pay.median.monthly | The middle of a month's pay |
| pay.mean.yearly | The average of a year's pay |
| pay.p90.hourly | The hourly pay that 90 per cent are paid less than |
| pay.mean.monthly.net | The average month's pay after tax |
| pay.monthly | A month's pay, published without naming its statistic |
The statistics are median, mean, p10 to p90, minimum (the legal minimum wage), starting and bonus; /v1/glossary explains each.
Every figure keeps its own currency and period
value is in the country's own currency, in whole units of money, as the office published it. Its period is a year (2025), a quarter (2025-Q2), a half (2025-H1) or a month (2025-06). Pro and Analyst add value_usd at the average rate of that period; Prices and money has the rest.
How /v1/pay finds the series
A country publishes many series for one name (by industry, sector, hours, groups). /v1/pay takes the one whose other parts are all totals where the country gives that, then the most recent, then everyone's hours. The same call always finds the same series, and the answer's series id lets you follow it over time with /v1/series/{id}/observations.
Left out, series is pay.median.monthly; when a country does not publish that, the answer gives the nearest figure it does publish and says so in meta.series.
The headline
Each country's headline (/v1/countries/{cc}/headline) is its figure for everyone, every occupation, gross: its median where it publishes one, else its mean, and the most recent.