Skip to main content
GET
Schools and Ratings

Authorizations

Authorization
string
header
required

Your access token or API key. Pass as Authorization: Bearer <token>.

Query Parameters

limit_to_district
boolean
default:true

If true, limits results to schools within the same school district as the search location. If false, searches nationwide.

level
enum<string>[]

Optional filter for school level. Valid values: 'elementary', 'middle', 'high'. You can include multiple levels separated by commas (e.g. 'elementary,middle'). If not specified, schools of all levels will be included.

Available options:
elementary,
middle,
high
limit
integer
default:10

The maximum number of closest schools to return (defaults to 10, maximum 50).

Required range: 1 <= x <= 50
lat
number
required

The latitude of the search location in decimal degrees (WGS 84). Must be between -90 and 90.

Required range: -90 <= x <= 90
lon
number
required

The longitude of the search location in decimal degrees (WGS 84). Must be between -180 and 180.

Required range: -180 <= x <= 180

Response

Successful Response

Schools matching the search criteria.

schools
SchoolSummary · object[]
required

A list of matching schools, sorted by proximity (only for location-based searches).

data_source
string
default:NCES Common Core of Data (CCD)

The authoritative source dataset for the school information.

data_vintage
integer | null
default:2025

The calendar year of the dataset used for these results.

additional_info
string | null

Any additional information or disclaimers about the search results.