Schola Data API — Free School Data for Developers

Quick start

No API key, no signup. Every file is a static JSON or CSV document served from our CDN with CORS enabled, so you can call it from a browser or a server.

curl https://schola.org/api/v1/index.json
curl https://schola.org/api/v1/regions/us/md.json
curl https://schola.org/api/v1/schools/us/md/us-240009000151.json

Endpoints

URL	Returns
`/api/v1/index.json`	Every country and state/region, with school counts and links to the lists below.
`/api/v1/regions/{country}/{region}.json`	Summary of every school in a state, e.g. `/regions/us/tx.json`: id, name, type, grades, city, Schola Grade, page URL and API URL.
`/api/v1/schools/{country}/{region}/{id}.json`	Full profile for one school: address, coordinates, phone, website, district, enrollment, students per teacher, and the full Schola Grade breakdown.
`/api/v1/bulk/{country}-{region}.csv`	The same data as one CSV per state, e.g. `us-ca.csv`. Best for loading into a database.
`/api/v1/scales.json`	The grading scale used in each country and the weight of each grade component.

School IDs

U.S. public schools use their NCES ID: us-{12-digit NCES ID} (e.g. us-240009000151), so you can join our data to any federal dataset. Private and international schools use {country}-{region}-{slug} or us-p-{NCES private school ID}. IDs are stable; URLs on schola.org may change if a school is renamed.

Example record

{
"id": "us-240009000151",
"name": "Baltimore Polytechnic Institute",
"type": "Public School",
"grades": "9–12",
"city": "Baltimore",
"region": "MD",
"schola_grade": {
"value": "A",
"description": "Excellent",
"scale": "Letter grade (A–F)",
"score": 92.6,
"method_version": "2026.2",
"compared_with": 204,
"comparison_group": "Maryland high schools",
"coverage": 1.0,
"components": {
"academics": {
"label": "Test scores",
"percentile": 92
},
"equity": {
"label": "Equity",
"percentile": 96
},
"attendance": {
"label": "Attendance",
"percentile": 75
},
"graduation": {
"label": "Graduation rate",
"percentile": 94
},
"college": {
"label": "College readiness",
"percentile": 94
},
"class_size": {
"label": "Class size",
"percentile": 7
}
},
"data_years": "test scores 2021–22, graduation and absenteeism 2022–23 (U.S. Department of Education, EDFacts); coursework 2023–24 (Civil Rights Data Collection); staffing 2024–25 (NCES)"
},
"schola_score": 92.6,
"url": "https://schola.org/schools/us/md/baltimore/baltimore-polytechnic-institute/",
"api": "https://schola.org/api/v1/schools/us/md/us-240009000151.json",
"level": "High",
"category": "Regular School",
"address": {
"street": "1400 W Cold Spring Lane",
"city": "Baltimore",
"region": "MD",
"region_name": "Maryland",
"postal_code": "21209",
"country": "US"
},
"location": {
"lat": 39.346,
"lon": -76.6431
},
"phone": "(410) 396-7026",
"website": "https://www.baltimorecityschools.org/schools/403",
"district": "Baltimore City Public Schools",
"county": "Baltimore City",
"enrollment": 1632,
"students_per_teacher": 19.2,
"charter": false,
"magnet": false,
"title_i": null,
"nces_id": "240009000151",
"urn": null,
"source": {
"name": "U.S. Department of Education (NCES Common Core of Data, Private School Survey, CRDC, EDFacts)",
"terms": "U.S. government work, public domain"
},
"license": {
"name": "CC BY 4.0",
"url": "https://creativecommons.org/licenses/by/4.0/",
"attribution": "Data by Schola (https://schola.org)"
}
}

Grade badge for your website

Show a school's Schola Grade on a listing or profile page with two lines of HTML. Every school page on Schola has a ready-made snippet under Embed this school's grade.

<div class="schola-badge" data-api="https://schola.org/api/v1/schools/us/md/us-240009000151.json"></div>
<script async src="https://schola.org/widgets/badge.js"></script>

Options: data-theme="dark" and data-compact="true".

License & attribution

Schola data is licensed under Creative Commons Attribution 4.0. You may use it for any purpose, including commercially, as long as you credit Schola wherever the data is shown:

Data by <a href="https://schola.org">Schola</a>

The badge widget includes attribution automatically. Underlying public-school records come from the U.S. Department of Education (NCES, CRDC, EDFacts), which are in the public domain.

Freshness, limits & good practice

Data is regenerated whenever sources update (federal datasets publish yearly). Each response carries method_version for grades.
Responses are cached for an hour. For large integrations, download the per-state CSVs instead of fetching every school file.
Grades compare schools within a state; don't compare grades across states. See how Schola Grades work.
A null grade means there isn't enough public data to grade fairly — never treat it as a low grade.

Partner access

Running a real-estate platform, relocation service, or research project and need higher volume, custom fields, webhooks on updates, or a commercial agreement? Tell us what you're building.