> ## 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 Districts > Returns the names and metadata of all school districts (Unified, Elementary, Secondary) that geographically overlap with the specified latitude and longitude. School district boundaries can overlap (e.g., an elementary district within a high school district). This data is provided by Federal NCES datasets. ## OpenAPI ````yaml /openapi.json get /schools/search/districts 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/search/districts: get: tags: - Schools & Ratings summary: School Districts description: >- Returns the names and metadata of all school districts (Unified, Elementary, Secondary) that geographically overlap with the specified latitude and longitude. School district boundaries can overlap (e.g., an elementary district within a high school district). This data is provided by Federal NCES datasets. operationId: ihuus_schools_search_districts parameters: - name: lat in: query required: true schema: type: number maximum: 90 minimum: -90 title: Lat description: Latitude of the search location (WGS 84). description: Latitude of the search location (WGS 84). - name: lon in: query required: true schema: type: number maximum: 180 minimum: -180 title: Lon description: Longitude of the search location (WGS 84). description: Longitude of the search location (WGS 84). responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/DistrictSearchResponse' '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: DistrictSearchResponse: properties: districts: items: $ref: '#/components/schemas/DistrictResult' type: array title: Districts description: List of school districts found at the location. additional_info: anyOf: - type: string - type: 'null' title: Additional Info description: Any additional information or disclaimers about the search results. type: object required: - districts title: DistrictSearchResponse description: API response model for school district search results. examples: - districts: - geoid: '0602310' higrade: '12' lograde: KG name: San Jose Unified School District rating: 7 rating_summary: >- Above-average district with strong academic outcomes and broad program variety; some achievement gaps across schools. rating_year: 2024 sd_type: Unified state_fp: '06' 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 DistrictResult: properties: name: type: string title: Name description: School District Name geoid: type: string title: Geoid description: Unique District GEOID state_fp: type: string title: State Fp description: State FIPS Code lograde: anyOf: - type: string - type: 'null' title: Lograde description: Lowest Grade Served higrade: anyOf: - type: string - type: 'null' title: Higrade description: Highest Grade Served sd_type: anyOf: - type: string - type: 'null' title: Sd Type description: School District Type rating: anyOf: - type: integer maximum: 10 minimum: 0 - type: 'null' title: Rating description: >- An overall rating for the school district on a scale of 1 to 10, where 10 represents the highest quality. 0 or null if no rating is available or if the district is outside the supported coverage area. rating_summary: anyOf: - type: string - type: 'null' title: Rating Summary description: >- A brief textual summary of the district's rating, if available. This may include key factors contributing to the rating or notable strengths and weaknesses. rating_year: anyOf: - type: integer - type: 'null' title: Rating Year description: >- The calendar year for which the district's rating is applicable. This helps users understand the timeliness of the rating information. type: object required: - name - geoid - state_fp title: DistrictResult description: Model representing a school district search result. examples: - geoid: '0602310' higrade: '12' lograde: KG name: San Jose Unified School District rating: 7 rating_summary: >- Above-average district with strong academic outcomes and broad program variety; some achievement gaps across schools. rating_year: 2024 sd_type: Unified state_fp: '06' 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 ``.' ````