--- title: "Returns a detailed record for one school" method: GET path: "/v1/schools/{id}" tags: ["Schools"] --- # Returns a detailed record for one school `GET /v1/schools/{id}` Retrieve a school record from the SchoolDigger database ## Path parameters - `id` string, required ## Query parameters - `appID` string, required - `appKey` string, required ## Response `200` OK - APISchool10Full - `schoolid` string — SchoolDigger School ID Number (12 digits) - `schoolName` string — School name - `phone` string — School phone number - `url` string — SchoolDigger URL for this school - `urlCompare` string — SchoolDigger URL for comparing this school to nearby schools - `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 - `locale` string — NCES urban-centric locale classification (e.g. 'City: Large', 'Suburb: Midsize', 'Rural: Fringe'). Categories: City (Large/Midsize/Small), Suburb (Large/Midsize/Small), Town (Fringe/Distant/Remote), Rural (Fringe/Distant/Remote). See https://nces.ed.gov/ccd/rural_locales.asp - `lowGrade` string — The low grade served by this school (PK = Prekindergarten, K = Kindergarten) - `highGrade` string — The high grade served by this school - `schoolLevel` string — The level of school (Elementary, Middle, High, Private, Alternative) - `isCharterSchool` string — Indicates if school is a charter school (Yes/No/n-a) - `isMagnetSchool` string — Indicates if school is a magnet school (Yes/No/n-a) - `isVirtualSchool` string — Indicates if school is a virtual school (Yes/No/n-a) - `isTitleISchool` string — Indicates if school is a Title I school (Yes/No/n-a) - `isTitleISchoolwideSchool` string — Indicates if a school-wide Title I school (Yes/No/n-a) - `isPrivate` boolean — Indicates if school is a private school (Yes/No) - `privateDays` integer — Days in the school year (private schools only) - `privateHours` number, double — Hours in the school day (private schools only) - `privateHasLibrary` boolean — Indicates if the school has a library (private schools only) - `privateCoed` string — Coed/Boys/Girls (private schools only) - `privateOrientation` string — Affiliation of the school (private schools only) - `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 - `district` APIDistrictSum — District Summary - `districtID` string — The 7 digit SchoolDigger District id number - `districtName` string - `url` string — The URL to see the district details on SchoolDigger - `rankURL` string — The URL to see the district in the SchoolDigger ranking list - `county` APICounty - `countyName` string — County in which the school or district is located - `countyURL` string — SchoolDigger URL for all schools in this county - `rankHistory` APIRankHistory[] — SchoolDigger yearly rank history for this school, sorted most recent year first. Schools are ranked within their state and level (Elementary, Middle, or High). Includes all available years — the full record returns more years than the summary in search results. - `year` integer — School year (2017 - 2016-17) - `rank` integer — Statewide rank of this School - `rankOf` integer — Count of schools ranked at this state/level - `rankStars` integer — The number of stars SchoolDigger awarded in the ranking of the school (0-5, 5 is best) - `rankLevel` string — The level for which this school is ranked (Elementary, Middle, High) - `rankStatewidePercentage` number, double — Percentile of this school's rank (e.g. this school performed better than (x)% of this state's elementary schools) - `averageStandardScore` number, double — The Average Standard score calculated by SchoolDigger (see: https://www.schooldigger.com/aboutrankingmethodology.aspx) - `rankMovement` integer — Returns the movement of rank for this school between current and previous year - `testScores` APITestScoreWrapper[] — Standardized test score results with school, district, and state comparisons. Each entry represents one test/subject/grade/year combination. Includes percent meeting standard and optional tier breakdowns (Enterprise level). Tests are state-specific (e.g. SBA, WCAS in WA; CAASPP in CA). 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. - `schoolYearlyDetails` APIYearlyDemographics[] — Yearly enrollment, demographics, and staffing for this school. Array is sorted most recent year first and includes all available years (back to 1988 for some schools). The full record returns more years than the summary in search results. - `year` integer — School year (2018 = 2017-18) - `numberOfStudents` integer — Count of students attending the school - `percentFreeDiscLunch` number, double — Percent of students receiving a free or discounted lunch in the National School Lunch Program - `percentofAfricanAmericanStudents` number, double — Percentage of students who are Black or African American (NCES definition: a person having origins in any of the black racial groups of Africa) - `percentofAsianStudents` number, double — Percentage of students who are Asian (NCES definition: a person having origins in any of the original peoples of the Far East, Southeast Asia, or the Indian subcontinent) - `percentofHispanicStudents` number, double — Percentage of students who are Hispanic or Latino (NCES definition: a person of Cuban, Mexican, Puerto Rican, South or Central American, or other Spanish culture or origin, regardless of race) - `percentofIndianStudents` number, double — Percentage of students who are American Indian or Alaska Native (NCES definition: a person having origins in any of the original peoples of North and South America who maintains tribal affiliation or community attachment) - `percentofPacificIslanderStudents` number, double — Percentage of students who are Native Hawaiian or Other Pacific Islander (NCES definition: a person having origins in any of the original peoples of Hawaii, Guam, Samoa, or other Pacific Islands) - `percentofWhiteStudents` number, double — Percentage of students who are White (NCES definition: a person having origins in any of the original peoples of Europe, the Middle East, or North Africa) - `percentofTwoOrMoreRaceStudents` number, double — Percentage of students reporting two or more races (not Hispanic/Latino) - `percentofUnspecifiedRaceStudents` number, double — Percentage of students whose race/ethnicity was not specified or reported - `teachersFulltime` number, double — Number of full-time equivalent teachers employed at the school - `pupilTeacherRatio` number, double — Number of students / number of full-time equivalent teachers - `numberofAfricanAmericanStudents` integer — NCES definition: A person having origins in any of the black racial groups of Africa. (https://nces.ed.gov/statprog/2002/std1_5.asp) - `numberofAsianStudents` integer — NCES definition: A person having origins in any of the original peoples of the Far East, Southeast Asia, or the Indian subcontinent, including, for example, Cambodia, China, India, Japan, Korea, Malaysia, Pakistan, the Philippine Islands, Thailand, and Vietnam. (https://nces.ed.gov/statprog/2002/std1_5.asp) - `numberofHispanicStudents` integer — NCES definition: A person of Cuban, Mexican, Puerto Rican, South or Central American, or other Spanish culture or origin, regardless of race. (https://nces.ed.gov/statprog/2002/std1_5.asp) - `numberofIndianStudents` integer — Count of American Indian or Alaska Native students (NCES definition: a person having origins in any of the original peoples of North and South America who maintains tribal affiliation or community attachment) - `numberofPacificIslanderStudents` integer — NCES definition: A person having origins in any of the original peoples of Hawaii, Guam, Samoa, or other Pacific Islands. (https://nces.ed.gov/statprog/2002/std1_5.asp) - `numberofWhiteStudents` integer — NCES definition: A person having origins in any of the original peoples of Europe, the Middle East, or North Africa. (https://nces.ed.gov/statprog/2002/std1_5.asp) - `numberofTwoOrMoreRaceStudents` integer — NCES definition: Includes any combination of two or more races and not Hispanic/Latino ethnicity. (https://nces.ed.gov/statprog/2002/std1_5.asp) - `numberofUnspecifiedRaceStudents` integer — Count of students whose race/ethnicity was not specified or reported --- [API](https://skmtc.net/schooldigger/apis/schooldigger-api-v1.md) · [All operations](https://skmtc.net/schooldigger/apis/schooldigger-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/schooldigger/schooldigger-api-v1/versions/955b719cf121/schema)