API Documentation
Introduction
The SchoolFinder API provides access to a comprehensive database of schools across India. You can search for schools by name, state, district, and other criteria. This API is free to use and open source.
The data is sourced from the AISHE and UDISE websites.
Note: The data was collected in 2024 and may not be updated.
Disclaimer & Terms of Use
The data provided by SchoolFinder is sourced from government websites and is offered "as-is" without any guarantees of accuracy or updates. Users are responsible for verifying the information independently.
By using this API, you agree that SchoolFinder and its developers are not liable for any inaccuracies, misuse, or legal issues arising from the use of this data.
Base URL
This API is provided as a free and open source service. There are no usage restrictions, but please be considerate with your request volume.
Endpoints
GET /schools
Search for schools with various filters
Query Parameters
| Parameter | Type | Description |
|---|---|---|
| query | string | Search term for school name or code |
| state | string | Filter by state name |
| district | string | Filter by district name |
| page | integer | Page number (default: 1) |
| limit | integer | Results per page (default: 10, max: 100) |
Example Request
Example Response
Error Codes
| Status Code | Description |
|---|---|
| 400 | Bad Request - Your request is invalid |
| 500 | Internal Server Error - We had a problem with our server |