Skip to main content

Search Schools

GET 
/v4/schools

Get a list of schools based on search criteria. Used to initially search for schools. Extra details can be found in the /v4/schools/{school-id} endpoint.

Request​

Query Parameters

    types string[]

    The types of schools returned. Public schools are schools that are payed for by the government.Private schools are schools that require extra payment to attend.Catholic schools are schools (primarily in Canada) that get government funding and are open to anyone to attend, but are owned and run by the Catholic church.

    Possible values: [public, private, catholic]

    Default value: [public, private]

    Examples:

    Example: public

    boundary-id string

    boundary id for which you seek to obtain school information from. This will return all schools with a school attendance boundary that overlaps this boundary, and private schools within ~1110 meters of the boundary. You must either provide a latitude and longitude or a boundary id.

    latitude number

    The latitude for which you seek to obtain school information from.Any schools attendance boundary that overlaps this coordinate will be returned.Any schools without a school attendance boundary, and is within the radius specified will be returned.You must either provide a latitude and longitude or a boundary id.

    longitude number

    The longitude for which you seek to obtain school information from.Any schools attendance boundary that overlaps this coordinate will be returned.Any schools without a school attendance boundary, and is within the radius specified will be returned.You must either provide a latitude and longitude or a boundary id.

    radius number

    The default radius is 1000 meters. You may use decimals as well.If you would like to get only schools that intersect the exact point, set the radius to 0.

    Default value: 1000

    limit number

    The number of records you would like returned. The default is 20, the maximum is 100.

    Default value: 20

    offset number

    Used for pagination, the number of records for the collection to skip.

    Default value: 0

    sort-by string

    This parameter changes the order of the results. The sort distance will be from the closest edge of the boundary, if boundary-id is provided. It will be from the coordinate if, latitude and longitude are provided.

    Possible values: [distance, type]

    Default value: distance

Responses​

Schema

    success booleanrequired

    pagination

    object

    required

    pageTotal numberrequired
    limit numberrequired
    offset numberrequired

    data

    object[]

  • Array [

    • schoolId stringrequired

    The national center for educational statistics (NCES) school ID.

    districtId stringrequired

    The district ID. Schools without districts will be assigned the value '99999'.

    districtName stringrequired

    The school's district name.

    schoolName stringrequired

    The school name.

    schoolType stringrequired

    The type of school.

    Possible values: [public, private, catholic]

    Example: public
    phone stringrequired

    The phone number of the school.

    website stringrequired

    The website of the school.

    street stringrequired

    The street address of the school.

    city stringrequired

    The city where the school is located.

    stateOrProvince stringrequired

    The state or province where the school is located.

    postalCode stringrequired

    The postal code of the school.

    country stringrequired

    The country where the school is located.

    addressFull stringrequired

    The full address of the school.

    lowGrade stringrequired

    The lowest grade offered by the school.

    highGrade stringrequired

    The highest grade offered by the school.

    schoolLevel stringnullablerequired

    The level of the school (e.g., Elementary, Middle, High, Private).

    Possible values: [Elementary, Middle, High, Private]

    isCharterSchool booleannullablerequired

    Flag to determine if this school is a charter school.

    isMagnetSchool booleannullablerequired

    Flag to determine if this school is a magnet school.

    isVirtualSchool booleannullablerequired

    Flag to determine if this school is a virtual school.

    isPrivate booleannullablerequired

    Flag to determine if this school is a private school, or a public school.

    rankHistory

    object[]

    required

    School rating based on standardized test assessments. This is a historical list of school ratings. For the most recent rating, use the first value from the array.

  • Array [

    • year numberrequired

    Year of the school assessment

    rank numberrequired

    How many other schools had a total score better than this school in the school district and of the same school type.

    rankOf numberrequired

    Total amount of schools in the district that were assessed and of the same school type.

    rankStars numberrequired

    The star rating of the school.

    Possible values: <= 5

    Example: 3
    rankLevel stringrequired

    The level of the school.

  • ]

    • schoolYearlyDetails

    object[]

    required

    Details about the school that change per year, including school attendance, and staffing. This is a historical list of school details. For the most recent detail, use the first value from the array.

  • Array [

    • year numberrequired

    Year of the school survey

    Example: 2019
    numberOfStudents numberrequired

    Number of students in the school

    Example: 1000
    percentFreeDiscLunch numberrequired

    Percent of students who receive free/reduced price lunch

    Example: 50
    percentOfAfricanAmericanStudents numberrequired

    Percent of students who are African American

    percentOfAsianStudents numberrequired

    Percent of students who are Asian

    percentOfHispanicStudents numberrequired

    Percent of students who are Hispanic

    percentOfIndianStudents numberrequired

    Percent of students who are Indian

    percentOfPacificIslanderStudents numberrequired

    Percent of students who are Pacific Islander

    percentOfWhiteStudents numberrequired

    Percent of students who are White

    percentOfTwoOrMoreRaceStudents numberrequired

    Percent of students who are two or more races

    percentOfUnspecifiedRaceStudents numberrequired

    Percent of students who are of an unspecified race

    teachersFulltime numberrequired

    Number of full time teachers

    pupilTeacherRatio numberrequired

    number of students per full time teacher

    numberOfAfricanAmericanStudents numberrequired

    number of students who are African American

    numberOfAsianStudents numberrequired

    number of students who are Asian

    numberOfHispanicStudents numberrequired

    number of students who are Hispanic

    numberOfIndianStudents numberrequired

    number of students who are Indian

    numberOfPacificIslanderStudents numberrequired

    number of students who are Pacific Islander

    numberOfWhiteStudents numberrequired

    number of students who are White

    numberOfTwoOrMoreRaceStudents numberrequired

    number of students who are two or more races

    numberOfUnspecifiedRaceStudents numberrequired

    number of students who are of an unspecified race

  • ]

    • giftedAndTalented booleannullablerequired

    Gifted and talented programs are programs during regular school hours that provide special educational opportunities including accelerated promotion through grades and classes and an enriched curriculum for students who give evidence of high achievement capability in areas such as intellectual, creative, artistic, or leadership capacity, or in specific academic fields.

    dualEnrollment booleannullablerequired

    Dual enrollment/dual credit programs provide opportunities for high school students to take college-level courses offered by colleges, and earn concurrent credit toward a high school diploma and a college degree while still in high school. These programs are for high school-enrolled students who are academically prepared to enroll in college and are interested in taking on additional coursework. For example, students who want to study subjects not offered at their high school may seek supplemental education at colleges nearby. Dual enrollment/dual credit programs do not include the Advanced Placement (AP) program or the International Baccalaureate Diploma Programme.

    creditRecovery booleannullablerequired

    Credit recovery programs (including courses or other instruction) aim to help more students graduate by giving students who have fallen behind the chance to “recover” credits through a multitude of different strategies, including online. Different programs allow students to work on their credit recovery classes over the summer, on school breaks, after school, on weekends, at home on their own, at night in school computer labs, or even during the school day.

    singleSexClasses booleannullablerequired

    Single-sex academic class refers to an academic class in a co-educational school that excludes boys or girls from enrolling or otherwise participating in that class because of their sex. A class is not considered single-sex so long as it does not exclude boys or girls, even if students of only one sex, or a disproportionate number of students of one sex, enroll.

    apCourse booleannullablerequired

    Advanced Placement (AP) refers to a program, sponsored by the College Board, through which students may earn college credit and advanced college placement by successfully completing AP courses and standardized AP exams.

    internationalBaccalaureate booleannullablerequired

    International Baccalaureate (IB) Diploma Programme, sponsored by the International Baccalaureate Organization, is designed as an academically challenging and balanced program of education with final examinations that prepares students, usually aged 16 to 19, for success at university and life beyond. The Programme is typically taught over two years. IB Diploma Programme students study six courses at higher level or standard level. Students must choose one subject from each of groups 1 to 5, thus ensuring breadth of experience in languages, social studies, the experimental sciences and mathematics. The sixth subject may be an arts subject chosen from group 6, or the student may choose another subject from groups 1 to 5. Additionally, IB Diploma Programme students must meet three core requirements: the extended essay, the theory of knowledge course, and a creativity/action/service experience.

    corporalPunishment booleannullablerequired

    Corporal punishment refers to paddling, spanking, or other forms of physical punishment imposed on a child.

    interscholarAthletics booleannullablerequired

    Interscholastic athletics refers to team-based organized sports activities that offer competition between schools.

    offersKindergarten booleannullablerequired

    Flag to indicate if this school offers Kindergarten.

    offersFullDayKindergarten booleannullablerequired

    Flag to indicate if this school offers Full Day Kindergarten.

    apEnrollment booleannullablerequired

    Amount of students enrolled in AP courses.

    expenditurePerStudent booleannullablerequired

    Amount of dollars spent per student each year.

    isTitleISchool booleannullablerequired

    Flag to indicate if this school offers Title I services.

    isTitleISchoolwideSchool booleannullablerequired

    Flag to indicate if this school is a exclusively providesd Title I services.

    privateHours numbernullablerequired

    Amount of hours a day the school is open. Only available for private schools.

    privateDays numbernullablerequired

    Amount of days a each year the school is open. Only available for private schools.

    privateHasLibrary booleannullablerequired

    Flag to indicate if this school has a private library. Only available for private schools.

    privateCoed stringnullablerequired

    Flag to determine if the school is coed or seperated by gender. Only available for private schools.

    Possible values: [Coed, Male, Female]

    latitude numberrequired

    The latitude location of the school.

    longitude numberrequired

    The longitude location of the school.

    hasBoundary booleanrequired

    Flag to determine if the school has an attendance boundary.

    distance numberrequired

    Distance to the school location in meters. If the geometry is a LiveBy boundary, it is distance to the edge of the boundary, or 0 if the school is inside the boundary.

    isAssigned booleanrequired

    Flag for if this school is the assigned school for current geometry.Many public schools allow attendance regardless of where the student lives, however will not provide bus services, or accommodations for those living outside the designated school attendance area.This flag is used to determine if the school district desginated the school to provide services to this location or not.

  • ]