Build with sourced district data
District finance and outcome records with official sources, hashes, and a keyless first request.
Read district finance and outcome records for published jurisdictions. Every value keeps its official source, exact locator and a SHA-256 hash of the source file. The open host at www.districtfacts.com works today and needs no key. The identical paths on api.districtfacts.com require a key, but sign-up is closed and keys are not being issued yet.
Your first request
- Request the API index without an account, package or key.
- Choose a jurisdiction and follow its
api_url. - Read a district record and keep its hash with your local copy.
curl
curl --fail --silent --show-error \
https://www.districtfacts.com/data/v1/index.jsoncurl
const response = await fetch("https://www.districtfacts.com/data/v1/index.json");
if (!response.ok) throw new Error(`HTTP ${response.status}`);
interface ApiIndex {
api_version: string;
states: Array<{ state: string; name: string; api_url: string }>;
}
const index = (await response.json()) as ApiIndex;
console.log(index.states.length, "published states");JavaScript
const response = await fetch("https://www.districtfacts.com/data/v1/index.json");
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const data = await response.json();
console.log(data);Python
import json
from urllib.request import Request, urlopen
request = Request("https://www.districtfacts.com/data/v1/index.json")
with urlopen(request, timeout=30) as response:
data = json.load(response)
print(json.dumps(data, indent=2))What one district record gives you
{
"name": "Capital School District",
"measure": {
"key": "edstats_revenue_per_pupil",
"value": 2592280,
"unit": "cents per pupil",
"period": "2024-2025",
"source_id": "de-edstats-fy25"
},
"resolved_source": {
"id": "de-edstats-fy25",
"source_host": "education.delaware.gov",
"sha256": "c0380d7f689ec95e539e9f88ac7151a02daab389e9b0382ab8a57de4d1968b49",
"url": "https://education.delaware.gov/wp-content/uploads/2026/05/fy25_edstats_final.pdf"
}
}Excerpt. The measure’s status, label, category, definition, and locator and the source’s locator and retrieved_at are omitted here; the full record includes them.