Documentation / Guides

Breakdowns | Salary Data API

Breakdowns

Sex, age, schooling, hours and area, and the gender pay gap.

Breakdowns come with Starter and above. Each country publishes its own: /v1/countries/{cc}/breakdowns lists its sexes, age bands, levels of schooling, hours and figures, and is the place to start.

occupationAn id or slug, or isco= with an ISCO-08 code
sexall, female or male
ageAn age band as the country publishes it, such as 25-34
educationA level of schooling as the country publishes it
hoursall, full_time or part_time
areaAn area id from /v1/countries/{cc}/areas

Side by side

/v1/pay/by-sex, /v1/pay/by-age and /v1/pay/by-education give a country's pay across one breakdown in one call.

The gender pay gap

/v1/pay/gender-gap (Analyst) is men's pay less women's, in per cent of men's, from figures the country publishes for both: by period for everyone, or by occupation or age band for the latest. A negative gap means women are paid more.