> ## Documentation Index > Fetch the complete documentation index at: https://docs.ihuus.com/llms.txt > Use this file to discover all available pages before exploring further. # School Detail > Returns full details for a single school identified by its 12-digit NCES ID, including contact information, enrollment figures, grade range, and rating. Use the school search or district search endpoints to obtain NCES IDs. ## OpenAPI ````yaml /openapi.json get /schools/school/{nces_id} openapi: 3.1.0 info: title: Neighborhood Intelligence API description: >- High-performance geospatial API for neighborhood-level intelligence. Covers K-12 school search and four scored dimension groups: Vibe (privacy, walkability, visual appeal, dog friendliness, urban-rural character, liveliness), Environment (acoustic comfort, air quality, industrial proximity), Demographics (health insurance coverage, ideological lean, population age profile), and Risk (flood and fire hazard). contact: name: iHuus, Inc. url: https://ihuus.com/ version: 0.1.0 servers: - url: https://api.ihuus.com/v1 description: iHuus API v1 security: - BearerAuth: [] tags: - name: Schools & Ratings description: >- Search for K-12 schools by geographic coordinates. Results include distance, school level, district information, demographics, and performance metrics where available. - name: Vibe description: >- Neighborhood vibe dimension scores. Each endpoint returns a 0-255 score for a single dimension (privacy, walkability, visual appeal, dog friendliness, urban-rural character) along with a semantic description. - name: Environment description: >- Environment dimension scores (0-255). Includes composite noise levels, air quality, and other environmental factors accompanied by detailed source breakdowns. - name: Demographics description: >- Demographic dimension scores (0-255) derived from US Census Bureau data. Includes health insurance coverage and other population-level indicators. - name: Risk description: >- Risk dimension scores (0-255). Covers natural hazard exposure including flood and fire risk, derived from FEMA and other authoritative hazard datasets. Lower scores indicate higher risk. - name: Tools description: >- Auxiliary tools for processing data and agent assistance, such as geocoding addresses into geospatial coordinates. paths: /schools/school/{nces_id}: get: tags: - Schools & Ratings summary: School Detail description: >- Returns full details for a single school identified by its 12-digit NCES ID, including contact information, enrollment figures, grade range, and rating. Use the school search or district search endpoints to obtain NCES IDs. operationId: ihuus_schools_get_school_by_id parameters: - name: nces_id in: path required: true schema: type: string description: The unique 12-digit NCES identifier for the school. title: Nces Id description: The unique 12-digit NCES identifier for the school. responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/SchoolResult' '401': description: Unauthorized — API key is missing, invalid, or expired. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' '429': description: Too Many Requests — rate limit or monthly quota exceeded. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' components: schemas: SchoolResult: properties: nces_id: type: string title: Nces Id description: >- The unique 12-digit National Center for Education Statistics (NCES) identifier for the school. name: type: string title: Name description: The official name of the school institution. lea_id: anyOf: - type: string - type: 'null' title: Lea Id description: >- The NCES Local Education Agency (LEA) identifier, identifying the school district. lea_name: anyOf: - type: string - type: 'null' title: Lea Name description: The name of the school district or Local Education Agency (LEA). level: anyOf: - type: string - type: 'null' title: Level description: >- The educational level(s) served by the school (e.g. 'Elementary', 'Middle', 'High'). lowest_grade: anyOf: - type: integer - type: 'null' title: Lowest Grade description: >- 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: anyOf: - type: integer - type: 'null' title: Highest Grade description: >- 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: anyOf: - type: integer maximum: 10 minimum: 0 - type: 'null' title: Rating description: >- An overall rating for the school on a scale of 1 to 10, where 10 represents the highest quality. 0 or null if no rating is available or if the school is outside the supported coverage area. lat: anyOf: - type: number - type: 'null' title: Lat description: The latitude of the school's location in decimal degrees (WGS 84). lon: anyOf: - type: number - type: 'null' title: Lon description: The longitude of the school's location in decimal degrees (WGS 84). distance_meters: anyOf: - type: number - type: 'null' title: Distance Meters description: >- The distance in meters from the search query coordinates to the school location. Only populated for coordinate-based searches. address: anyOf: - type: string - type: 'null' title: Address description: >- The full physical address of the school, including street, city, state, and zip code. phone: anyOf: - type: string - type: 'null' title: Phone description: The primary contact phone number for the school. website: anyOf: - type: string - type: 'null' title: Website description: The URL of the official school website. total_students: anyOf: - type: integer - type: 'null' title: Total Students description: The total number of students enrolled at the school. total_teachers: anyOf: - type: integer - type: 'null' title: Total Teachers description: >- The total number of full-time equivalent (FTE) teachers at the school. student_teacher_ratio: anyOf: - type: number - type: 'null' title: Student Teacher Ratio description: The student-to-teacher ratio at the school. state_student_teacher_ratio: anyOf: - type: number - type: 'null' title: State Student Teacher Ratio description: >- 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: anyOf: - type: integer - type: 'null' title: Num Ethn White description: The number of enrolled students identified as White (NCES category). num_ethn_asian: anyOf: - type: integer - type: 'null' title: Num Ethn Asian description: The number of enrolled students identified as Asian (NCES category). num_ethn_baa: anyOf: - type: integer - type: 'null' title: Black or African American Students description: >- The number of enrolled students identified as Black or African American (NCES category). num_ethn_hispanic: anyOf: - type: integer - type: 'null' title: Num Ethn Hispanic description: >- The number of enrolled students identified as Hispanic or Latino (NCES category). num_ethn_hawaii_pacific: anyOf: - type: integer - type: 'null' title: Num Ethn Hawaii Pacific description: >- The number of enrolled students identified as Native Hawaiian or Other Pacific Islander (NCES category). num_ethn_american_indian: anyOf: - type: integer - type: 'null' title: Num Ethn American Indian description: >- The number of enrolled students identified as American Indian or Alaska Native (NCES category). num_ethn_other: anyOf: - type: integer - type: 'null' title: Num Ethn Other description: >- The number of enrolled students identified as Two or More Races or Other (NCES categories). num_male: anyOf: - type: integer - type: 'null' title: Num Male description: The number of enrolled male students at the school. num_female: anyOf: - type: integer - type: 'null' title: Num Female description: The number of enrolled female students at the school. rating_source: anyOf: - type: string - type: 'null' title: Rating Source description: >- 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: anyOf: - type: string - type: 'null' title: Rating Description description: A textual description of the school's rating, if available. type: object required: - nces_id - name title: SchoolResult description: |- Detailed school record including contact information, enrollment figures, and rating attribution. examples: - address: 555 Dana Ave, San Jose, CA 95126 distance_meters: 1240.5 highest_grade: 12 lat: 37.3382 lea_id: '0602310' lea_name: San Jose Unified School District level: High lon: -121.8863 lowest_grade: 9 name: Lincoln High School nces_id: '060231001587' phone: (408) 535-6300 rating: 7 rating_source: California Department of Education total_students: 1842 total_teachers: 94 website: https://www.sjusd.org/lincoln/ ErrorResponse: type: object properties: detail: type: string description: Human-readable error message. required: - detail title: ErrorResponse description: >- Standard error response returned on authentication failure and rate-limit violations. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError securitySchemes: BearerAuth: type: http scheme: bearer description: 'Your access token or API key. Pass as ``Authorization: Bearer ``.' ````