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

  1. Request the API index without an account, package or key.
  2. Choose a jurisdiction and follow its api_url.
  3. 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.json

curl

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.

Developer documentation