--- title: "Returns a list of districts" method: GET path: "/v1/districts" tags: ["Districts"] --- # Returns a list of districts `GET /v1/districts` Search the SchoolDigger database for districts. You may use any combination of criteria as query parameters. ## Query parameters - `st` string, required - `q` string - `city` string - `zip` string - `nearLatitude` number, double - `nearLongitude` number, double - `boundaryAddress` string - `distanceMiles` integer - `isInBoundaryOnly` boolean - `boxLatitudeNW` number, double - `boxLongitudeNW` number, double - `boxLatitudeSE` number, double - `boxLongitudeSE` number, double - `page` integer - `perPage` integer - `sortBy` string - `includeUnrankedDistrictsInRankSort` boolean - `appID` string, required - `appKey` string, required ## Response `200` OK - APIDistrictList - `numberOfDistricts` integer — The total count of districts that match your query - `numberOfPages` integer — The total count of pages in your query list based on given per_page value - `districtList` APIDistrict1Summary[] - `districtID` string — SchoolDigger District ID Number (7 digits). Use /districts/{districtID} to retrieve the entire district record - `districtName` string — District name - `phone` string — District phone number - `url` string — SchoolDigger URL for this district - `address` APILocation - `latLong` APILatLong - `latitude` number, double — Latitude coordinate of the school or district address (WGS84 decimal degrees) - `longitude` number, double — Longitude coordinate of the school or district address (WGS84 decimal degrees, negative for Western Hemisphere) - `street` string — Street address of the school or district (e.g. '18500 37th Avenue N.E.') - `city` string — City where the school or district is located - `state` string — Two-letter state abbreviation (e.g. 'WA') - `stateFull` string — Full state name (WA = Washington) - `zip` string — 5-digit ZIP code - `zip4` string — ZIP+4 suffix (4 digits, may be empty) - `cityURL` string — SchoolDigger URL for schools in this city - `zipURL` string — SchoolDigger URL for schools in this zip code - `html` string — HTML formatted address - `locationIsWithinBoundary` boolean — Indicates whether this school's boundary includes the specified location from nearLatitude/nearLongitude or boundaryAddress (Enterprise API level) - `hasBoundary` boolean — Indicates that an attendance boundary is available for this district. (To retrieve, look up district with /districts/{id}) - `distance` number, double — Distance from nearLatitude/nearLongitude (if supplied) - `isWithinBoundary` boolean — Indicates whether this district's boundary includes the specified location from nearLatitude/nearLongitude - `county` APICounty - `countyName` string — County in which the school or district is located - `countyURL` string — SchoolDigger URL for all schools in this county - `lowGrade` string — The low grade served by this district (PK = Prekindergarten, K = Kindergarten) - `highGrade` string — The high grade served by this district - `numberTotalSchools` integer — Count of schools in the district - `numberPrimarySchools` integer — Count of schools designated as primary schools - `numberMiddleSchools` integer — Count of schools designated as middle schools - `numberHighSchools` integer — Count of schools designated as high schools - `numberAlternativeSchools` integer — Count of schools designated as other/alternative schools - `rankHistory` APILEARankHistory[] — SchoolDigger yearly rank history of the district - `year` integer — School year (2017 - 2016-17) - `rank` integer — Statewide rank of this district - `rankOf` integer — Count of district ranked in this state - `rankStars` integer — The number of stars SchoolDigger awarded in the ranking of the district (0-5, 5 is best) - `rankStatewidePercentage` number, double — Percentile of this district's rank (e.g. this district performed better than (x)% of this state's districts) - `rankScore` number, double — The rank score calculated by SchoolDigger (see https://www.schooldigger.com/aboutranking.aspx) - `districtYearlyDetails` APILEAYearlyDetail[] — District yearly metrics - `year` integer — School year (2018 = 2017-18) - `numberOfStudents` integer — Number of students enrolled in the district - `numberOfSpecialEdStudents` integer — The number of students having a written Individualized Education Program (IEP) under the Individuals With Disabilities Education Act (IDEA) - `numberOfEnglishLanguageLearnerStudents` integer — The number of English language learner (ELL) students served in appropriate programs - `numberOfTeachers` number, double — Number of full-time equivalent teachers employed by the district - `numberOfTeachersPK` number, double — Number of full-time equivalent pre-kindergarten teachers employed by the district - `numberOfTeachersK` number, double — Number of full-time equivalent kindergarten teachers employed by the district - `numberOfTeachersElementary` number, double — Number of full-time equivalent elementary teachers employed by the district - `numberOfTeachersSecondary` number, double — Number of full-time equivalent secondary teachers employed by the district - `numberOfAids` number, double — Number of full-time equivalent instructional aids employed by the district - `numberOfCoordsSupervisors` number, double — Number of full-time equivalent instructional coordinators/supervisors employed by the district - `numberOfGuidanceElem` number, double — Number of full-time equivalent elementary guidance counselors employed by the district - `numberOfGuidanceSecondary` number, double — Number of full-time equivalent secondary guidance counselors employed by the district - `numberOfGuidanceTotal` number, double — Total number of full-time equivalent guidance counselors employed by the district - `numberOfLibrarians` number, double — Number of full-time equivalent librarians/media specialists employed by the district - `numberOfLibraryStaff` number, double — Number of full-time equivalent librarians/media support staff employed by the district - `numberOfLEAAdministrators` number, double — Number of full-time equivalent LEA administrators employed by the district (LEA) - `numberOfLEASupportStaff` number, double — Number of full-time equivalent LEA administrative support staff employed by the district (LEA) - `numberOfSchoolAdministrators` number, double — Number of full-time equivalent school administrators employed by the district (LEA) - `numberOfSchoolAdminSupportStaff` number, double — Number of full-time equivalent school administrative support staff employed by the district (LEA) - `numberOfStudentSupportStaff` number, double — Number of full-time equivalent student support services staff employed by the district (LEA) - `numberOfOtherSupportStaff` number, double — Number of full-time equivalent all other support staff employed by the district (LEA) --- [API](https://skmtc.dev/schooldigger/apis/schooldigger-api-v1.md) · [All operations](https://skmtc.dev/schooldigger/apis/schooldigger-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/schooldigger/schooldigger-api-v1/revisions/955b719cf121/schema)