--- title: "Returns a list of schools" method: GET path: "/v1/schools" tags: ["Schools"] --- # Returns a list of schools `GET /v1/schools` Search the SchoolDigger database for schools. You may use any combination of criteria as query parameters. ## Query parameters - `st` string, required - `q` string - `qSearchSchoolNameOnly` boolean - `districtID` string - `level` string - `city` string - `zip` string - `isMagnet` boolean - `isCharter` boolean - `isVirtual` boolean - `isTitleI` boolean - `isTitleISchoolwide` boolean - `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 - `includeUnrankedSchoolsInRankSort` boolean - `appID` string, required - `appKey` string, required ## Response `200` OK - APISchoolList - `numberOfSchools` integer — The total count of schools that match your query - `numberOfPages` integer — The total count of pages in your query list based on given per_page value - `schoolList` APISchool1Summary[] - `schoolid` string — SchoolDigger School ID Number (12 digits). Use /schools/{schoolID} to retrieve the full school record - `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 others - `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 - `distance` number, double — Distance from nearLatitude/nearLongitude (if supplied) - `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) - `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 of the school. To retrieve all years, call /schools/{id}. - `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 - `hasBoundary` boolean — Indicates that an attendance boundary is available for this school. - `locationIsWithinBoundary` boolean — Indicates whether this school's boundary includes the specified location from nearLatitude/nearLongitude or boundaryAddress. (Enterprise API level only) - `schoolYearlyDetails` APIYearlyDemographics[] — School Yearly metrics. To retrieve all years, call /schools/{id}. - `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 - `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) --- [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)