---
title: "Returns a SchoolDigger district ranking list"
method: GET
path: "/v1/rankings/districts/{st}"
tags: ["Rankings"]
---

# Returns a SchoolDigger district ranking list

`GET /v1/rankings/districts/{st}`

## Request

- Base URL: `https://api.schooldigger.com`
- URL: `https://api.schooldigger.com/v1/rankings/districts/{st}`
- Auth: none declared

## Path parameters

- `st` string, required

## Query parameters

- `year` integer
- `page` integer
- `perPage` integer
- `appID` string, required
- `appKey` string, required

## Response `200`

OK

- APIDistrictListRank
  - `rankYear` integer: Year this ranking list represents (2018 = 2017-18)
  - `rankYearCompare` integer: Year rankings returned for comparison (2018 = 2017-18)
  - `rankYearsAvailable` integer[]: The years for which SchoolDigger district rankings are available for this state
  - `numberOfDistricts` integer: The total count of districts in the entire rank list
  - `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)
  - `rankCompareYear` integer

---

[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.dev/schooldigger/apis/schooldigger-api-v1/revisions/955b719cf121?raw)
