v1

latestSwagger 2.02026-07-1362046.5 KB
Rankings

Returns a SchoolDigger school ranking list

get/v1/rankings/schools/{st}

Path parameters

ststring required

Two character state (e.g. 'CA')

Query parameters

yearinteger

The ranking year (leave blank for most recent year)

levelstring

Level of ranking: 'Elementary', 'Middle', or 'High'

pageinteger

Page number to retrieve (optional, default: 1)

perPageinteger

Number of schools to retrieve on a page (50 max) (optional, default: 10)

appIDstring required

Your API app id

appKeystring required

Your API app key

Response

OK

rankYearinteger

Year this ranking list represents (2018 = 2017-18)

rankYearCompareinteger

Year rankings returned for comparison (2018 = 2017-18)

rankYearsAvailableinteger[]

The years for which SchoolDigger rankings are available for this state and level

numberOfSchoolsinteger

The total count of schools in this ranking list

numberOfPagesinteger

The total count of pages this ranking list based on given per_page value