---
title: "One gated college."
method: GET
path: "/api/v1/colleges/{slug}.json"
---

# One gated college.

`GET /api/v1/colleges/{slug}.json`

## Request

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

## Path parameters

- `slug` string, required

## Response `200`

The college with its meta block.

- object: One gated four-year institution (IPEDS 2023 · FREOPP 2021 · BEA 2023). Gates: real FREOPP earnings, >= 3 reported programs, hand-verified exclusions, positive 30-year NPV at resident pricing — no school outside the gate appears, and no named school carries a negative number.
  - `meta` Meta: 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
  - `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.

## Other responses

- `404`: Unknown slug — the school is outside the gate or not covered.

---

[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)