GET /schools.json
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)
(string, query, required)
API key for authentication. Obtain free at https://api.data.gov/signup
(string, query, optional)
Comma-separated list of fields to return. Use wildcards like 'school', 'latest', 'latest.cost'. Default returns all fields.
(integer, query, optional)
Filter by institution ID (IPEDS UNITID)
(boolean, query, optional, default: False)
Return true JSON objects instead of dotted strings (true/false)
(string, query, optional)
Filter by admission rate range (e.g., 0.1..0.5 for 10%-50%)
Constraints: {'pattern': '^\\d*\\.\\d*\\.\\.\\d*\\.\\d*$'}
(string, query, optional)
Filter by completion rate range
(string, query, optional)
Filter by average net price range (e.g., 10000..20000)
Constraints: {'pattern': '^\\d+\\.\\.\\d*$'}
(string, query, optional)
Filter by median earnings 10 years after entry
Constraints: {'pattern': '^\\d+\\.\\.\\d*$'}
(string, query, optional)
Filter by student enrollment range (e.g., 1000..5000)
Constraints: {'pattern': '^\\d+\\.\\.\\d*$'}
(integer, query, optional, default: 0)
Page number for pagination (0-indexed)
(integer, query, optional, default: 20)
Number of results per page (max 100)
Constraints: {'maximum': 100}
(integer, query, optional)
Filter by Carnegie Classification
(string, query, optional)
Filter by city name
(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]}
(integer, query, optional)
Filter by HBCU status: 0=No, 1=Yes
Constraints: {'enum': [0, 1]}
(string, query, optional)
Filter by institution name (partial match supported)
(integer, query, optional)
Filter by ownership type: 1=Public, 2=Private Nonprofit, 3=Private For-profit
Constraints: {'enum': [1, 2, 3]}
(integer, query, optional)
Filter by US region ID (1-10)
Constraints: {'minimum': 1, 'maximum': 10}
(string, query, optional)
Filter by state abbreviation (e.g., CA, NY, TX)
Constraints: {'pattern': '^[A-Z]{2}$'}
(string, query, optional)
Filter by ZIP code
(string, query, optional)
Sort field. Append :asc or :desc for direction (e.g., 'school.name:asc')
No probe data for this endpoint yet.