Get School Earnings
scorecard_get_earningsRead-onlyIdempotent
Institution-level post-graduation earnings for one school — median and percentiles at 6, 8, and 10 years after entry, with optional gender breakdown. This reflects outcomes across all graduates, not broken down by program. For program-specific earnings use scorecard_get_programs. For ROI analysis combining cost and debt data use scorecard_value_analysis. The years parameter accepts a list of cohort entry years for historical trend queries — omit for current snapshot only.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | School ID from scorecard_search_schools. | |
| years | No | Optional list of cohort entry years for historical trend data (e.g. [2011, 2012, 2013]). Omit for current snapshot. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | Present when the call failed. Absent on success. | |
| trend | No | Historical trend rows by cohort entry year. Present only when years parameter was supplied. | |
| current | No | Most recent available earnings snapshot. | |
| school_id | No | School unit ID. | |
| suppressed | No | True when earnings data is suppressed across all time points. | |
| school_name | No | Institution name. | |
| suppression_note | No | Explains suppression when suppressed=true. |