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

    successbooleanrequired

    pagination

    object

    required

    pageTotalnumberrequired
    limitnumberrequired
    offsetnumberrequired

    data

    object[]

  • Array [

    • schoolIdstringrequired

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

    districtIdstringrequired

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

    districtNamestringrequired

    The school's district name.

    schoolNamestringrequired

    The school name.

    schoolTypestringrequired

    The type of school.

    Possible values: [public, private, catholic]

    Example: public
    phonestringrequired

    The phone number of the school.

    websitestringrequired

    The website of the school.

    streetstringrequired

    The street address of the school.

    citystringrequired

    The city where the school is located.

    stateOrProvincestringrequired

    The state or province where the school is located.

    postalCodestringrequired

    The postal code of the school.

    countrystringrequired

    The country where the school is located.

    addressFullstringrequired

    The full address of the school.

    lowGradestringrequired

    The lowest grade offered by the school.

    highGradestringrequired

    The highest grade offered by the school.

    schoolLevelstringnullablerequired

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

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

    isCharterSchoolbooleannullablerequired

    Flag to determine if this school is a charter school.

    isMagnetSchoolbooleannullablerequired

    Flag to determine if this school is a magnet school.

    isVirtualSchoolbooleannullablerequired

    Flag to determine if this school is a virtual school.

    isPrivatebooleannullablerequired

    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 [

    • yearnumberrequired

    Year of the school assessment

    ranknumberrequired

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

    rankOfnumberrequired

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

    rankStarsnumberrequired

    The star rating of the school.

    Possible values: <= 5

    Example: 3
    rankLevelstringrequired

    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 [

    • yearnumberrequired

    Year of the school survey

    Example: 2019
    numberOfStudentsnumberrequired

    Number of students in the school

    Example: 1000
    percentFreeDiscLunchnumberrequired

    Percent of students who receive free/reduced price lunch

    Example: 50
    percentOfAfricanAmericanStudentsnumberrequired

    Percent of students who are African American

    percentOfAsianStudentsnumberrequired

    Percent of students who are Asian

    percentOfHispanicStudentsnumberrequired

    Percent of students who are Hispanic

    percentOfIndianStudentsnumberrequired

    Percent of students who are Indian

    percentOfPacificIslanderStudentsnumberrequired

    Percent of students who are Pacific Islander

    percentOfWhiteStudentsnumberrequired

    Percent of students who are White

    percentOfTwoOrMoreRaceStudentsnumberrequired

    Percent of students who are two or more races

    percentOfUnspecifiedRaceStudentsnumberrequired

    Percent of students who are of an unspecified race

    teachersFulltimenumberrequired

    Number of full time teachers

    pupilTeacherRationumberrequired

    number of students per full time teacher

    numberOfAfricanAmericanStudentsnumberrequired

    number of students who are African American

    numberOfAsianStudentsnumberrequired

    number of students who are Asian

    numberOfHispanicStudentsnumberrequired

    number of students who are Hispanic

    numberOfIndianStudentsnumberrequired

    number of students who are Indian

    numberOfPacificIslanderStudentsnumberrequired

    number of students who are Pacific Islander

    numberOfWhiteStudentsnumberrequired

    number of students who are White

    numberOfTwoOrMoreRaceStudentsnumberrequired

    number of students who are two or more races

    numberOfUnspecifiedRaceStudentsnumberrequired

    number of students who are of an unspecified race

  • ]

    • giftedAndTalentedbooleannullablerequired

    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.

    dualEnrollmentbooleannullablerequired

    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.

    creditRecoverybooleannullablerequired

    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.

    singleSexClassesbooleannullablerequired

    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.

    apCoursebooleannullablerequired

    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.

    internationalBaccalaureatebooleannullablerequired

    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.

    corporalPunishmentbooleannullablerequired

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

    interscholarAthleticsbooleannullablerequired

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

    offersKindergartenbooleannullablerequired

    Flag to indicate if this school offers Kindergarten.

    offersFullDayKindergartenbooleannullablerequired

    Flag to indicate if this school offers Full Day Kindergarten.

    apEnrollmentbooleannullablerequired

    Amount of students enrolled in AP courses.

    expenditurePerStudentbooleannullablerequired

    Amount of dollars spent per student each year.

    isTitleISchoolbooleannullablerequired

    Flag to indicate if this school offers Title I services.

    isTitleISchoolwideSchoolbooleannullablerequired

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

    privateHoursnumbernullablerequired

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

    privateDaysnumbernullablerequired

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

    privateHasLibrarybooleannullablerequired

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

    privateCoedstringnullablerequired

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

    Possible values: [Coed, Male, Female]

    latitudenumberrequired

    The latitude location of the school.

    longitudenumberrequired

    The longitude location of the school.

    hasBoundarybooleanrequired

    Flag to determine if the school has an attendance boundary.

    distancenumberrequired

    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.

    isAssignedbooleanrequired

    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.

  • ]