Skip to main content
GET
/
schools
/
school
/
{nces_id}
Error
A valid request URL is required to generate request examples
{
  "nces_id": "<string>",
  "name": "<string>",
  "lea_id": "<string>",
  "lea_name": "<string>",
  "level": "<string>",
  "lowest_grade": 123,
  "highest_grade": 123,
  "rating": 5,
  "lat": 123,
  "lon": 123,
  "distance_meters": 123,
  "address": "<string>",
  "phone": "<string>",
  "website": "<string>",
  "total_students": 123,
  "total_teachers": 123,
  "student_teacher_ratio": 123,
  "state_student_teacher_ratio": 123,
  "num_ethn_white": 123,
  "num_ethn_asian": 123,
  "num_ethn_baa": 123,
  "num_ethn_hispanic": 123,
  "num_ethn_hawaii_pacific": 123,
  "num_ethn_american_indian": 123,
  "num_ethn_other": 123,
  "num_male": 123,
  "num_female": 123,
  "rating_source": "<string>",
  "rating_description": "<string>"
}

Authorizations

​
Authorization
string
header
required

Your access token or API key. Pass as Authorization: Bearer <token>.

Path Parameters

​
nces_id
string
required

The unique 12-digit NCES identifier for the school.

Response

Successful Response

Detailed school record including contact information, enrollment figures, and rating attribution.

​
nces_id
string
required

The unique 12-digit National Center for Education Statistics (NCES) identifier for the school.

​
name
string
required

The official name of the school institution.

​
lea_id
string | null

The NCES Local Education Agency (LEA) identifier, identifying the school district.

​
lea_name
string | null

The name of the school district or Local Education Agency (LEA).

​
level
string | null

The educational level(s) served by the school (e.g. 'Elementary', 'Middle', 'High').

​
lowest_grade
integer | null

The lowest grade level served by the school. Values: -1=Pre-Kindergarten (PK), 0=Kindergarten (KG), 1-12=Grades 1-12, 13=Ungraded (UG), 14=Adult Education (AE).

​
highest_grade
integer | null

The highest grade level served by the school. Values: -1=Pre-Kindergarten (PK), 0=Kindergarten (KG), 1-12=Grades 1-12, 13=Ungraded (UG), 14=Adult Education (AE).

​
rating
integer | null

An overall rating for the school on a scale of 1 to 10, where 10 represents the highest quality.

Required range: 0 <= x <= 10
​
lat
number | null

The latitude of the school's location in decimal degrees (WGS 84).

​
lon
number | null

The longitude of the school's location in decimal degrees (WGS 84).

​
distance_meters
number | null

The distance in meters from the search query coordinates to the school location. Only populated for coordinate-based searches.

​
address
string | null

The full physical address of the school, including street, city, state, and zip code.

​
phone
string | null

The primary contact phone number for the school.

​
website
string | null

The URL of the official school website.

​
total_students
integer | null

The total number of students enrolled at the school.

​
total_teachers
integer | null

The total number of full-time equivalent (FTE) teachers at the school.

​
student_teacher_ratio
number | null

The student-to-teacher ratio at the school.

​
state_student_teacher_ratio
number | null

The average student-to-teacher ratio for the school group (e.g. Elementary, Middle, High) and state in which the school is located for benchmarking purposes.

​
num_ethn_white
integer | null

The number of enrolled students identified as White (NCES category).

​
num_ethn_asian
integer | null

The number of enrolled students identified as Asian (NCES category).

​
num_ethn_baa
integer | null

The number of enrolled students identified as Black or African American (NCES category).

​
num_ethn_hispanic
integer | null

The number of enrolled students identified as Hispanic or Latino (NCES category).

​
num_ethn_hawaii_pacific
integer | null

The number of enrolled students identified as Native Hawaiian or Other Pacific Islander (NCES category).

​
num_ethn_american_indian
integer | null

The number of enrolled students identified as American Indian or Alaska Native (NCES category).

​
num_ethn_other
integer | null

The number of enrolled students identified as Two or More Races or Other (NCES categories).

​
num_male
integer | null

The number of enrolled male students at the school.

​
num_female
integer | null

The number of enrolled female students at the school.

​
rating_source
string | null

The source of the school's overall rating. This could be an identifier for the organization or system that provided the rating. Use for citations and attributions.

​
rating_description
string | null

A textual description of the school's rating, if available.