# SchoolDigger API

> Comprehensive K-12 school and district data for the United States

SchoolDigger provides a RESTful JSON API with data on 120,000+ public and private schools and 18,500+ districts across all 50 states. Data includes enrollment, demographics, test scores, rankings, school finance, graduation rates, dropout rates, chronic absenteeism, and attendance boundaries.

Trusted by Money Magazine, Century 21, Harvard, IXL, Precisely, Coldwell Banker, and Franklin Covey.

## Base URL

    https://api.schooldigger.com/v2.3

## Authentication

All requests require `appID` and `appKey` query parameters. Get your free API key at https://developer.schooldigger.com

Example: `GET /v2.3/schools?st=WA&q=Lincoln&appID={appID}&appKey={appKey}`

## Endpoints

- `GET /v2.3/schools` -- Search schools by state, city, zip, keyword, location, bounding box, or type (charter, magnet, virtual, Title I, private). Returns summary records with rankings and yearly demographics. Requires `st` parameter.
- `GET /v2.3/schools/{id}` -- Full school record by 12-digit SchoolDigger ID. Includes test scores, finance, reviews, graduation/dropout/chronic absenteeism rates, rank history, and yearly demographics.
- `GET /v2.3/districts` -- Search districts by state, city, zip, keyword, location, or bounding box. Returns summary records with rankings and yearly staffing details. Requires `st` parameter.
- `GET /v2.3/districts/{id}` -- Full district record by 7-digit SchoolDigger ID. Includes test scores, finance, attendance boundary, graduation/dropout/chronic absenteeism rates, rank history, and yearly staffing.
- `GET /v2.3/rankings/schools/{st}` -- Statewide school ranking list. Filter by year and level (Elementary, Middle, High).
- `GET /v2.3/rankings/districts/{st}` -- Statewide district ranking list. Filter by year.
- `GET /v2.3/autocomplete/schools` -- Fast typeahead school search. Supports state, level, district, and bounding box filters.
- `GET /v2.3/autocomplete/districts` -- Fast typeahead district search. Supports state and bounding box filters.

## Data Highlights

- Up to 10 years of enrollment and demographic history
- 20+ million test score records with school, district, and state comparisons
- Up to 10 years of SchoolDigger 0-5 star rankings
- School finance data with per-student spending breakdowns
- 4-year graduation rates, dropout rates, and chronic absenteeism rates
- Attendance boundary polygons for districts (Pro/Enterprise)
- Proximity and boundary-containment searches (Pro/Enterprise)

## Year Convention

Year values represent the spring year of the school year: `2025` means the 2024-25 school year.

## API Plans

- DEV/TEST: Free (limited calls)
- Basic: $19.90/mo
- Pro: $89/mo (adds geo search, boundaries, finance, test scores)
- Enterprise: $189/mo (adds boundary containment, tiered test scores, detailed finance)
- Autocomplete-only plans also available

## Documentation

- Swagger spec: https://api.schooldigger.com/swagger/docs/v2.3
- Interactive docs: https://developer.schooldigger.com/docs
- Full LLM reference: https://developer.schooldigger.com/llms-full.txt