v1
latestSwagger 2.02026-07-1362046.5 KBReturns a list of schools
Search the SchoolDigger database for schools. You may use any combination of criteria as query parameters.
Query parameters
Two character state (e.g. 'CA') - required
Search term - note: will match school name or city (optional)
For parameter 'q', only search school names instead of school and city (optional)
Search for schools within this district (7 digit district id) (optional)
Search for schools at this level. Valid values: 'Elementary', 'Middle', 'High', 'Alt', 'Public', 'Private' (optional). 'Public' returns all Elementary, Middle, High and Alternative schools
Search for schools in this city (optional)
Search for schools in this 5-digit zip code (optional)
True = return only magnet schools, False = return only non-magnet schools (optional) (Pro, Enterprise API levels only)
True = return only charter schools, False = return only non-charter schools (optional) (Pro, Enterprise API levels only)
True = return only virtual schools, False = return only non-virtual schools (optional) (Pro, Enterprise API levels only)
True = return only Title I schools, False = return only non-Title I schools (optional) (Pro, Enterprise API levels only)
True = return only Title I school-wide schools, False = return only non-Title I school-wide schools (optional) (Pro, Enterprise API levels only)
Search for schools within (distanceMiles) of (nearLatitude)/(nearLongitude) (e.g. 44.982560) (optional) (Pro, Enterprise API levels only. Enterprise API level will flag schools that include lat/long in its attendance boundary.)
Search for schools within (distanceMiles) of (nearLatitude)/(nearLongitude) (e.g. -124.289185) (optional) (Pro, Enterprise API levels only. Enterprise API level will flag schools that include lat/long in its attendance boundary.)
Full U.S. address: flag returned schools that include this address in its attendance boundary. Example: '123 Main St. AnyTown CA 90001' (optional) (Enterprise API level only) IMPORTANT NOTE: If you have the lat/long of the address, use nearLatitude and nearLongitude instead for much faster response times
Search for schools within (distanceMiles) of (nearLatitude)/(nearLongitude) (Default 5 miles) (optional) (Pro, Enterprise API levels only)
Return only the schools that include given location (nearLatitude/nearLongitude) or (boundaryAddress) in its attendance boundary (Enterprise API level only)
Search for schools within a 'box' defined by (boxLatitudeNW/boxLongitudeNW) to (boxLongitudeSE/boxLatitudeSE) (optional)
Search for schools within a 'box' defined by (boxLatitudeNW/boxLongitudeNW) to (boxLongitudeSE/boxLatitudeSE) (optional)
Search for schools within a 'box' defined by (boxLatitudeNW/boxLongitudeNW) to (boxLongitudeSE/boxLatitudeSE) (optional)
Search for schools within a 'box' defined by (boxLatitudeNW/boxLongitudeNW) to (boxLongitudeSE/boxLatitudeSE) (optional)
Page number to retrieve (optional, default: 1)
Number of schools to retrieve on a page (50 max) (optional, default: 10)
Sort list. Values are: schoolname, distance, rank. For descending order, precede with '-' i.e. -schoolname (optional, default: schoolname)
If sortBy is 'rank', this boolean determines if schools with no rank are included in the result (optional, default: false)
Your API app id
Your API app key
Response
OK