--- title: "Returns a detailed record for one district" method: GET path: "/v1/districts/{id}" tags: ["Districts"] --- # Returns a detailed record for one district `GET /v1/districts/{id}` Retrieve a single district record from the SchoolDigger database ## Path parameters - `id` string, required ## Query parameters - `appID` string, required - `appKey` string, required ## Response `200` OK - APIDistrict - `districtID` string — SchoolDigger District ID Number (7 digits) - `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 - `boundary` APIBoundary - `polylineCollection` APIPolyline[] — Collection of one or more polylines that can be used to create the boundary on a map. NOTE: this value is JSON encoded. Specifically, backslashes will be returned escaped (two backslashes). Make sure to decode the polyline before you use it - `polylineOverlayEncodedPoints` string — Google Maps encoded polyline string for rendering the boundary on a map. Compatible with google.maps.geometry.encoding.decodePath() and similar libraries. IMPORTANT: Backslashes are JSON-escaped (appear as \\). Unescape to single backslashes before decoding. - `numberEncodedPoints` integer — Number of encoded points in polyline - `hasBoundary` boolean — States whether there is a boundary available - `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 - `numberPrimarySchools` integer - `numberMiddleSchools` integer - `numberHighSchools` integer - `numberAlternativeSchools` integer - `rankHistory` APILEARankHistory[] — SchoolDigger yearly rank history for this district, sorted most recent year first. Districts are ranked statewide regardless of level. - `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[] — Yearly enrollment and staffing details for this district. Array is sorted most recent year first. Includes detailed FTE staffing breakdowns by role (teachers by level, administrators, counselors, librarians, support staff). - `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) - `testScores` APITestScoreWrapper[] — Standardized test score results with district and state comparisons. Each entry represents one test/subject/grade/year combination. District-level records do not include schoolTestScore. Requires Pro or Enterprise API subscription. - `test` string — The name of the state-administered test - `subject` string — Test subject - `year` integer — Year test was administered (2018 = 2017-18) - `grade` string — Grade level for which this test score applies (e.g. '3', '5', '8', '10', 'HS') - `schoolTestScore` APITestScore - `studentsEligible` integer — Count of students eligible to take test - `studentsTested` integer — Count of students tested - `meanScaledScore` number, float — Mean scale score - `percentMetStandard` number, float — Percent of students meeting state standard - `numberMetStandard` number, float — Count of students meeting state standard - `numTier1` integer — Count of students performing at tier 1 (Enterprise API level only) - `numTier2` integer — Count of students performing at tier 2 (Enterprise API level only) - `numTier3` integer — Count of students performing at tier 3 (Enterprise API level only) - `numTier4` integer — Count of students performing at tier 4 (Enterprise API level only) - `numTier5` integer — Count of students performing at tier 5 (Enterprise API level only) - `percentTier1` number, float — Percent of students performing at tier 1 (Enterprise API level only) - `percentTier2` number, float — Percent of students performing at tier 2 (Enterprise API level only) - `percentTier3` number, float — Percent of students performing at tier 3 (Enterprise API level only) - `percentTier4` number, float — Percent of students performing at tier 4 (Enterprise API level only) - `percentTier5` number, float — Percent of students performing at tier 5 (Enterprise API level only) - `districtTestScore` APITestScore - `studentsEligible` integer — Count of students eligible to take test - `studentsTested` integer — Count of students tested - `meanScaledScore` number, float — Mean scale score - `percentMetStandard` number, float — Percent of students meeting state standard - `numberMetStandard` number, float — Count of students meeting state standard - `numTier1` integer — Count of students performing at tier 1 (Enterprise API level only) - `numTier2` integer — Count of students performing at tier 2 (Enterprise API level only) - `numTier3` integer — Count of students performing at tier 3 (Enterprise API level only) - `numTier4` integer — Count of students performing at tier 4 (Enterprise API level only) - `numTier5` integer — Count of students performing at tier 5 (Enterprise API level only) - `percentTier1` number, float — Percent of students performing at tier 1 (Enterprise API level only) - `percentTier2` number, float — Percent of students performing at tier 2 (Enterprise API level only) - `percentTier3` number, float — Percent of students performing at tier 3 (Enterprise API level only) - `percentTier4` number, float — Percent of students performing at tier 4 (Enterprise API level only) - `percentTier5` number, float — Percent of students performing at tier 5 (Enterprise API level only) - `stateTestScore` APITestScore - `studentsEligible` integer — Count of students eligible to take test - `studentsTested` integer — Count of students tested - `meanScaledScore` number, float — Mean scale score - `percentMetStandard` number, float — Percent of students meeting state standard - `numberMetStandard` number, float — Count of students meeting state standard - `numTier1` integer — Count of students performing at tier 1 (Enterprise API level only) - `numTier2` integer — Count of students performing at tier 2 (Enterprise API level only) - `numTier3` integer — Count of students performing at tier 3 (Enterprise API level only) - `numTier4` integer — Count of students performing at tier 4 (Enterprise API level only) - `numTier5` integer — Count of students performing at tier 5 (Enterprise API level only) - `percentTier1` number, float — Percent of students performing at tier 1 (Enterprise API level only) - `percentTier2` number, float — Percent of students performing at tier 2 (Enterprise API level only) - `percentTier3` number, float — Percent of students performing at tier 3 (Enterprise API level only) - `percentTier4` number, float — Percent of students performing at tier 4 (Enterprise API level only) - `percentTier5` number, float — Percent of students performing at tier 5 (Enterprise API level only) - `tier1` string — Label for the lowest performance tier on this test (e.g. 'Below Basic', 'Level 1'). Tier labels are state-specific. Enterprise API level only. - `tier2` string — Label for the second performance tier (e.g. 'Basic', 'Level 2'). Enterprise API level only. - `tier3` string — Label for the third performance tier (e.g. 'Proficient', 'Level 3'). Enterprise API level only. - `tier4` string — Label for the fourth performance tier (e.g. 'Advanced', 'Level 4'). Enterprise API level only. - `tier5` string — Label for the fifth performance tier, if applicable (e.g. 'No Score'). Not all states use 5 tiers. Enterprise API level only. --- [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)