---
title: "One state’s best-value colleges at resident pricing — slim per-state slice."
method: GET
path: "/api/v1/rankings/best-value/{state}.json"
---

# One state’s best-value colleges at resident pricing — slim per-state slice.

`GET /api/v1/rankings/best-value/{state}.json`

## Request

- Base URL: `https://le-teen.com`
- URL: `https://le-teen.com/api/v1/rankings/best-value/{state}.json`
- Auth: none declared

## Path parameters

- `state` 'al' | 'ak' | 'az' | 'ar' | 'ca' | 'co' | 'ct' | 'de' | 'dc' | 'fl' | 'ga' | 'hi' | 'id' | 'il' | 'in' | 'ia' | 'ks' | 'ky' | 'la' | 'me' | 'md' | 'ma' | 'mi' | 'mn' | 'ms' | 'mo' | 'mt' | 'ne' | 'nv' | 'nh' | 'nj' | 'nm' | 'ny' | 'nc' | 'nd' | 'oh' | 'ok' | 'or' | 'pa' | 'ri' | 'sc' | 'sd' | 'tn' | 'tx' | 'ut' | 'vt' | 'va' | 'wa' | 'wv' | 'wi' | 'wy', required

## Response `200`

Top 15 for the state, NPV-positive rows only.

- object
  - `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
  - `title` string
  - `description` string
  - `page_url` string, uri
  - `state` string
  - `state_name` string
  - `count` integer
  - `colleges` object[]
    - `rank_in_state` integer
    - `institution` string
    - `city` string
    - `control` string
    - `npv_30yr_resident_usd` integer

## Other responses

- `404`: Not a USPS state code.

---

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