Get School Programs
scorecard_get_programsRead-onlyIdempotent
All field-of-study programs at one school with median earnings 1 year after the highest credential, cumulative Stafford/Grad PLUS debt, and IPEDS award counts for each year of the pooled debt cohort. This is the primary source for program-level earnings — institution-level 6/8/10-year earnings are available via scorecard_get_earnings. Earnings may be suppressed (null) for programs with small cohorts due to FERPA privacy protection; suppressed=true flags this explicitly. Use scorecard_lookup_cip to find CIP codes by name.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | School ID from scorecard_search_schools. | |
| cip_code | No | Filter to one 4-digit CIP code, dotted or undotted (e.g. "11.07" or "1107" for Computer Science). Returns one row per credential level the school offers in that program. | |
| min_earnings | No | Minimum 1-year post-graduation median earnings filter. | |
| credential_level | No | Filter by credential level: 1=undergraduate certificate, 2=associate, 3=bachelor, 4=post-baccalaureate certificate, 5=master, 6=doctoral, 7=first professional, 8=graduate/professional certificate, 99=non-credential. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| error | No | Present when the call failed. Absent on success. | |
| query | No | Normalized effective school ID and program selectors. | |
| total | No | Total programs returned after filtering. | |
| notice | No | Guidance when no programs match the filters or all data is suppressed. | |
| programs | No | All programs at this school matching the filters. Sorted by median earnings descending (suppressed programs at end). | |
| school_id | No | School unit ID. | |
| school_name | No | Institution name. | |
| suppressed_count | No | Number of programs with earnings suppressed due to small cohort. |