---
title: "National institution-count coverage plus the unchanged 500 gated four-year colleges."
method: GET
path: "/api/v1/colleges.json"
---

# National institution-count coverage plus the unchanged 500 gated four-year colleges.

`GET /api/v1/colleges.json`

## Request

- Base URL: `https://le-teen.com`
- URL: `https://le-teen.com/api/v1/colleges.json`
- Auth: none declared

## Response `200`

National eligible sign/funnel/model coverage followed by the unchanged named positive/top-500 selection.

- object
  - `meta` Meta, required: Provenance block carried by every payload. `generated` is the build-time page-review stamp (static files); `data_vintage` names the upstream survey years.
    - `source` 'LE TEEN', required
    - `url` string, uri, required
    - `license` 'CC-BY-4.0', required
    - `doi` string, uri, required
    - `data_vintage` string, required
    - `generated` string, date, required
  - `count` integer, required
  - `notes` string[], required
  - `coverage` CollegeCoverage, required: National unweighted institution-count coverage before the positive/top-500 gate. Unknown values are separate from zero and negative; the negative share is not a graduate probability. No negative institution identifiers are emitted.
    - `schema` 'college-projected-value-coverage/v1', required
    - `population` string, required
    - `weighting` string, required
    - `funnel` object, required
      - `all_institutions` integer, required
      - `institution_level_unknown` integer, required
      - `not_four_year` integer, required
      - `four_year` integer, required
      - `earnings_unavailable` integer, required
      - `earnings_invalid` integer, required
      - `real_earnings` integer, required
      - `program_coverage_invalid` integer, required
      - `below_three_programs` integer, required
      - `at_least_three_programs` integer, required
      - `hand_excluded` integer, required
      - `missing_state_rpp` integer, required
      - `state_rpp_invalid` integer, required
      - `quality_eligible` integer, required
    - `modeled_net_value_signs` object, required
      - `positive` integer, required
      - `zero` integer, required
      - `negative` integer, required
      - `unknown` integer, required
    - `finite_modeled_denominator` integer, required
    - `negative_share_of_finite_eligible` number, nullable, required: Negative / (positive + zero + negative), a fraction of finite eligible institution rows; null with no finite denominator. Unknown models are excluded.
    - `assumptions` object, required
      - `program_years` integer, required
      - `career_horizon_years` integer, required
      - `loan_pct` number, required
      - `loan_apr` number, required
      - `loan_term_years` integer, required
      - `alt_investment_apr` number, required
      - `hs_grad_annual_wage` number, required
      - `pricing` string, required
    - `metric` object, required
      - `legacy_field` 'npv_30yr_resident_usd', required
      - `calculation` string, required
      - `meaning` string, required: Canonical rounded accumulated/terminal net value at year 34 with four study and thirty career years; not standard present value, realized loss or FREOPP published lifetime ROI.
      - `career_horizon_years` integer, required
      - `terminal_years_after_start` integer, required
    - `earnings_proxy` object, required
      - `basis` string, required
      - `price_year` unknown, required
      - `horizon_applicability` 'unknown', required
      - `completion_probability` unknown, required
    - `named_selection_unchanged` object, required
      - `positive_only` true, required
      - `limit` 500, required
      - `ordering` string, required
    - `source_vintages` object, required
      - `ipeds` '2023', required
      - `freopp_publication` '2021', required
      - `bea` '2023', required
    - `sources` object, required
      - `institutions` string, required
      - `bea_rpp` string, required
      - `methodology` string, uri, required
      - `freshness` string, required
  - `colleges` College[], required
    - `slug` string, required
    - `unitid` integer, required: IPEDS UnitID — the universal join key.
    - `name` string, required
    - `city` string, required
    - `state` string, required: USPS 2-letter state code.
    - `state_name` string
    - `control` 'public' | 'private-nonprofit' | 'private-forprofit', required
    - `npv_30yr_resident_usd` integer, required: Legacy field name: canonical accumulated/terminal projected net value at year 34 (four study years plus thirty career years), at resident pricing. Positive by gate; not standard discounted present value or FREOPP published lifetime ROI.
    - `npv_30yr_nonresident_usd` integer, nullable: Non-resident 30-year NPV — public schools with a real out-of-state premium only, and only when ALSO positive; null otherwise by design.
    - `total_cost_of_attendance_usd` integer
    - `total_cost_of_attendance_nonresident_usd` integer, nullable
    - `median_earnings_10yr_usd` integer: Legacy field name: institution cohort-weighted FREOPP Estimated earnings, ages 29–31; an age-band proxy, not a measured ten-year-post-entry median.
    - `breakeven_age` integer, nullable
    - `freopp_program_coverage` integer: FREOPP-reported programs rolled into the earnings figure.
    - `url` string, uri, required: The human-readable page for this school.

---

[API](https://skmtc.dev/le-teen/apis/le-teen-college-roi-api.md) · [All operations](https://skmtc.dev/le-teen/apis/le-teen-college-roi-api/llms.txt) · [OpenAPI document](https://skmtc.dev/le-teen/apis/le-teen-college-roi-api/revisions/14495b804989?raw)