leo_earnings
Retrieve graduate earnings data for a UK provider, including lower-quartile, median and upper-quartile earnings at 1, 3 and 5 years, by subject, with UK-wide comparison.
Instructions
Graduate earnings (DfE Longitudinal Education Outcomes) for one provider.
Returns lower-quartile, median and upper-quartile annualised earnings at
1, 3 and 5 years after graduation, by CAH2 subject, with the UK-wide
figure on the same cut for context. Always quote the median with its
quartiles — the spread is usually the story — and say how many graduates
the figure is based on.
Args:
ukprn: Provider id from search_providers.
subject: Optional CAH2 subject name filter, e.g. "Law", "Computing"
(partial match). Omit for all subjects.
years_after: 1, 3 or 5 (years after graduation). Omit for all three.
tax_year: e.g. "2022/2023". Omit for the latest available.
characteristic_type: "All graduates" (default), or a split:
"sex", "ethnicity", "POLAR4", "prior_attainment_code".
characteristic_value: Value within the split, e.g. "F", "M".
Honest limits, worth repeating to the user: these are pre-tax earnings of
UK graduates in sustained employment whose records matched tax data —
the self-employed abroad, or those out of work, aren't in the medians.
Earnings reflect where graduates live and work (London weighting is
real), and nothing here is causal: a subject's high earnings may be who
it admits, not what it teaches. No figures on application volumes,
satisfaction or dropout — other tools cover the latter two.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ukprn | Yes | ||
| subject | No | ||
| tax_year | No | ||
| years_after | No | ||
| characteristic_type | No | All graduates | |
| characteristic_value | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |