GET /schools.json

ed.gov:college-scorecard-api

Summary: Search and filter colleges
Operation ID: searchSchools
Auth: unknown
Description

Search for colleges by name, location, or other criteria. Returns a paginated list of institutions matching the query parameters.

Parameters (21)

api_key (string, query, required)

API key for authentication. Obtain free at https://api.data.gov/signup

fields (string, query, optional)

Comma-separated list of fields to return. Use wildcards like 'school', 'latest', 'latest.cost'. Default returns all fields.

id (integer, query, optional)

Filter by institution ID (IPEDS UNITID)

keys_nested (boolean, query, optional, default: False)

Return true JSON objects instead of dotted strings (true/false)

latest.admissions.admission_rate.overall__range (string, query, optional)

Filter by admission rate range (e.g., 0.1..0.5 for 10%-50%)

Constraints: {'pattern': '^\\d*\\.\\d*\\.\\.\\d*\\.\\d*$'}

latest.completion.rate_suppressed.overall__range (string, query, optional)

Filter by completion rate range

latest.cost.avg_net_price.overall__range (string, query, optional)

Filter by average net price range (e.g., 10000..20000)

Constraints: {'pattern': '^\\d+\\.\\.\\d*$'}

latest.earnings.10_yrs_after_entry.median__range (string, query, optional)

Filter by median earnings 10 years after entry

Constraints: {'pattern': '^\\d+\\.\\.\\d*$'}

latest.student.size__range (string, query, optional)

Filter by student enrollment range (e.g., 1000..5000)

Constraints: {'pattern': '^\\d+\\.\\.\\d*$'}

page (integer, query, optional, default: 0)

Page number for pagination (0-indexed)

per_page (integer, query, optional, default: 20)

Number of results per page (max 100)

Constraints: {'maximum': 100}

school.carnegie_basic (integer, query, optional)

Filter by Carnegie Classification

school.city (string, query, optional)

Filter by city name

school.degrees_awarded.highest (integer, query, optional)

Filter by highest degree awarded: 0=Non-degree, 1=Certificate, 2=Associate, 3=Bachelor's, 4=Graduate

Constraints: {'enum': [0, 1, 2, 3, 4]}

school.minority_serving.historically_black (integer, query, optional)

Filter by HBCU status: 0=No, 1=Yes

Constraints: {'enum': [0, 1]}

school.name (string, query, optional)

Filter by institution name (partial match supported)

school.ownership (integer, query, optional)

Filter by ownership type: 1=Public, 2=Private Nonprofit, 3=Private For-profit

Constraints: {'enum': [1, 2, 3]}

school.region_id (integer, query, optional)

Filter by US region ID (1-10)

Constraints: {'minimum': 1, 'maximum': 10}

school.state (string, query, optional)

Filter by state abbreviation (e.g., CA, NY, TX)

Constraints: {'pattern': '^[A-Z]{2}$'}

school.zip (string, query, optional)

Filter by ZIP code

sort (string, query, optional)

Sort field. Append :asc or :desc for direction (e.g., 'school.name:asc')

No probe data for this endpoint yet.