Documentation / Pay
Pay | Salary Data API
PayThe pay figure you ask for: a country, a statistic and period of pay, and any breakdown. The latest period unless you ask for others.
GEThttps://api.salarydataapi.com/v1/pay
Try it
No key in this browser yet. Get a free key: it is filled in here once made.
Runs against the live API with your key.
curl "https://api.salarydataapi.com/v1/pay" \ -H "Authorization: Bearer YOUR_KEY"
Parameters
| Name | Type | What it is |
|---|---|---|
| country | country | required Two-letter country code |
| series | string | The figure wanted, as pay.<statistic>.<period>: pay.median.monthly, pay.mean.yearly, pay.median.hourly, pay.p90.yearly.... Default pay.median.monthly. |
| occupation | id | An occupation id (oc_...) or its slug, such as software-developers |
| isco | string | An ISCO-08 occupation code (1 to 4 digits), where the country publishes by ISCO |
| sex | string | Sex. Default all. allfemalemale |
| age | string | An age band as /v1/countries/{cc}/breakdowns lists it, such as 25-34 |
| education | string | A level of schooling as /v1/countries/{cc}/breakdowns lists it |
| hours | string | Full-time, part-time or everyone. Default all. allfull_timepart_time |
| area | id | An area (ar_...); the whole country when left out |
| period | period | One period; the latest when left out |
| from | period | The first period wanted (2019, 2019-Q1 or 2019-01) |
| to | period | The last period wanted |
| page | integer | The page, from 1. Default 1. |
| per_page | integer | Items a page, at most 200. Default 50. |
| cursor | string | From 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.
| Field | Type | What it holds |
|---|---|---|
| series | id | The series (se_...) |
| name | string | What the figure is, as pay.<statistic>.<period>, for example pay.median.monthly |
| country | string | Two-letter country code |
| period | period | The period the figure covers: 2025, 2025-Q2 or 2025-06 |
| value | number | The figure in its own currency, in whole units of money |
| currency | string | ISO 4217 currency |
| value_usd | number | The figure in US dollars at that period's rate (Pro and Analyst; null on other plans) |
| occupation | id | The occupation (oc_...), or null for all occupations |
| sex | string | all, female or male |
| age | string | The age band, or null for all ages |
| education | string | The level of schooling, or null for all levels |
| hours | string | all, full_time or part_time |
| area | string | The area, or null for the whole country |
Example answer
Run it with your key for a real answer.