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

https://schoolsfinder.vercel.app

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

ParameterTypeDescription
querystringSearch term for school name or code
statestringFilter by state name
districtstringFilter by district name
pageintegerPage number (default: 1)
limitintegerResults per page (default: 10, max: 100)

Example Request

GET /schools?query=delhi

Example Response

{ "totalItems": 10, "totalPages": 1, "page": 1, "search": "delhi", "next": "https://schoolsfinder.vercel.app/schools?query=delhi&state=&page=2&limit=10", "results": [ { "id": 433289, "udiseschcode": "23500822114", "universityname": null, "universityid": null, "universitytype": null, "collegename": null, "collegeid": null, "collegetype": null, "institutionname": null, "institutionid": null, "institutiontype": null, "address": null, "website": null, "specialisedin": null, "schoolname": "Privt. HSS DELHI PUBLIC SCHOOL VINDHYA NAGAR", "schooltype": "Pr. with Up.Pr. Sec. and H.Sec.", "pincode": 486885, "locality": "Urban", "category": 3, "type": 3, "classfrom": 1, "classto": 12, "status": null, "state": "MADHYA PRADESH", "district": "SINGRAULI", "block": "WAIDHAN", "cluster": "Govt. HSS GIRLS WAIDHAN", "village": "NAGAR NIGAM (S) WARD 40", "management": "Private Unaided (Recognized)", "yearofestablishment": null, "yearwhendecalreduniversity": null, "uploadyear": null, "instituteaddedinsurveyyear": null }, // More results... ] },

Error Codes

Status CodeDescription
400Bad Request - Your request is invalid
500Internal Server Error - We had a problem with our server