API v1 reference · 1.9.0

Every DistrictFacts API v1 endpoint, parameter, response field, status, and example.

Endpoint index

Nested object schemas

measures[] item

A published, withheld, or not-collected district measure. Fields vary by status.

status ("published" | "withheld" | "not_collected", always required) — Current status value.; key (string, always required) — Stable machine-readable measure key.; label (string, always required) — Human-readable measure or row label.; category (string · finance | students | staff | outcomes | programs | climate | funding | fiscal, always required) — Measure category used to group related values.; period (string) — Reporting period the value describes.; definition (string) — Scope and meaning of the measure as published.; value (number) — Exact stored value; monetary units remain integer cents.; unit (string) — Unit used by the exact stored value.; source_id (string) — Key in the district record's sources registry.; locator (string) — Exact row, cell, filter, or calculation location within the source.; position_class ("single_position") — Identifies a published leadership salary held by one position.; reason (string · agency_suppressed | failed_distribution_gate | definition_not_comparable | source_unverified | superseded_pending_review | privacy_review) — Reason files are held, or null when they are published.; note (string) — Context needed to interpret this object.; capability (string · finance_detail | funding_taxes | staffing | outcomes | students | programs | climate | fiscal_transparency | trends | comparisons | schools) — Data capability that was not collected..

sources registry entry

The object stored under each source_id key in a district record.

id (string, always required) — Stable identifier.; url (string · uri, always required) — URL of the referenced resource.; sha256 (string, always required) — SHA-256 hash of the exact file bytes.; locator (string, always required) — Exact row, cell, filter, or calculation location within the source.; retrieved_at (string · date-time, always required) — UTC time when DistrictFacts retrieved the source.; source_host (string, always required) — Hostname of the official source URL.; citation (object) — Optional agency citation, included on every Michigan source; keep it with the source URL and link when reusing a figure..

schools[] item

A school and its separately scoped measures.

code (string, always required) — Source-system code for the school or line item.; name (string, always required) — Human-readable name.; grades (string, always required) — Grade span reported for the school.; page_url (string · uri, always required) — Public DistrictFacts page for this district.; measures (SchoolCell[], always required) — Published, withheld, and not-collected district cells.; notice (Notice) — Context that changes how the record's figures should be read..

GET /data/v1/openapi.yaml

Get the OpenAPI 3.1 contract for this API

Status codes: 200 (open and keyed) — OpenAPI 3.1 contract; 304 (open and keyed) — ; 400 (open and keyed) — ; 401 (open and keyed) — ; 403 (open and keyed) — ; 404 (open and keyed) — ; 429 (open and keyed) — ; 500 (open and keyed) — ; 304 (keyed) — Keyed host response when If-None-Match matches the current ETag; 405 (keyed) — Method is not GET or HEAD.

Open-host response headers: Content-Type: application/yaml; charset=utf-8; Access-Control-Allow-Origin: *; X-Robots-Tag: noindex. Keyed-host response headers: Content-Type: application/yaml; charset=utf-8; Access-Control-Allow-Origin: *; X-Robots-Tag: noindex; Cache-Control: private, max-age=300; Vary: Authorization, X-API-Key, Accept-Encoding; ETag: weak tag built from the file SHA-256; X-DistrictFacts-Release: release identifier; X-Request-Id: request UUID; X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, X-RateLimit-Resource, RateLimit-Policy; Retry-After: present when the service can state a retry delay; Content-Length: response bytes on a 200 response.

Response fields: .

curl

curl --fail --silent --show-error \
  https://www.districtfacts.com/data/v1/openapi.yaml

curl

const response = await fetch("https://www.districtfacts.com/data/v1/openapi.yaml");
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const text: string = await response.text();
console.log(text);

JavaScript

const response = await fetch("https://www.districtfacts.com/data/v1/openapi.yaml");
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const text = await response.text();
console.log(text);

Python

from urllib.request import Request, urlopen

request = Request("https://www.districtfacts.com/data/v1/openapi.yaml")
with urlopen(request, timeout=30) as response:
    text = response.read().decode("utf-8")
print(text)

Response excerpt

openapi: 3.1.0
info:
  title: DistrictFacts Public Data API
  version: 1.8.0

Excerpt. Paths, servers, licence metadata, the full description, and components are omitted.

GET /data/v1/changelog.json

Get the API v1 release history

Status codes: 200 (open and keyed) — Ordered API v1 changelog; 304 (open and keyed) — ; 400 (open and keyed) — ; 401 (open and keyed) — ; 403 (open and keyed) — ; 404 (open and keyed) — ; 429 (open and keyed) — ; 500 (open and keyed) — ; 304 (keyed) — Keyed host response when If-None-Match matches the current ETag; 405 (keyed) — Method is not GET or HEAD.

Open-host response headers: Content-Type: application/json; charset=utf-8; Access-Control-Allow-Origin: *; X-Robots-Tag: noindex. Keyed-host response headers: Content-Type: application/json; charset=utf-8; Access-Control-Allow-Origin: *; X-Robots-Tag: noindex; Cache-Control: private, max-age=300; Vary: Authorization, X-API-Key, Accept-Encoding; ETag: weak tag built from the file SHA-256; X-DistrictFacts-Release: release identifier; X-Request-Id: request UUID; X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, X-RateLimit-Resource, RateLimit-Policy; Retry-After: present when the service can state a retry delay; Content-Length: response bytes on a 200 response.

Response fields: date (string · date, required) — Calendar date of the release.; version (string, required) — Semantic version of the API release.; changes[] (string[], required) — Ordered descriptions of changes in this release..

curl

curl --fail --silent --show-error \
  https://www.districtfacts.com/data/v1/changelog.json

curl

const response = await fetch("https://www.districtfacts.com/data/v1/changelog.json");
if (!response.ok) throw new Error(`HTTP ${response.status}`);
interface ChangelogEntry {
  date: string;
  version: string;
  changes: string[];
}

const releases = (await response.json()) as ChangelogEntry[];
console.log(releases.length, "releases");

JavaScript

const response = await fetch("https://www.districtfacts.com/data/v1/changelog.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/changelog.json")
with urlopen(request, timeout=30) as response:
    data = json.load(response)
print(json.dumps(data, indent=2))

Real response excerpt

[{
  "date": "2026-10-08",
  "version": "1.7.0",
  "changes": ["Added a status list for all 23 jurisdictions: which have open-data files, and why the others are held."]
}]

Excerpt. The other changelog entries are omitted.

GET /data/v1/index.json

List available states

Status codes: 200 (open and keyed) — State index; 304 (open and keyed) — ; 400 (open and keyed) — ; 401 (open and keyed) — ; 403 (open and keyed) — ; 404 (open and keyed) — ; 429 (open and keyed) — ; 500 (open and keyed) — ; 304 (keyed) — Keyed host response when If-None-Match matches the current ETag; 405 (keyed) — Method is not GET or HEAD.

Open-host response headers: Content-Type: application/json; charset=utf-8; Access-Control-Allow-Origin: *; X-Robots-Tag: noindex. Keyed-host response headers: Content-Type: application/json; charset=utf-8; Access-Control-Allow-Origin: *; X-Robots-Tag: noindex; Cache-Control: private, max-age=300; Vary: Authorization, X-API-Key, Accept-Encoding; ETag: weak tag built from the file SHA-256; X-DistrictFacts-Release: release identifier; X-Request-Id: request UUID; X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, X-RateLimit-Resource, RateLimit-Policy; Retry-After: present when the service can state a retry delay; Content-Length: response bytes on a 200 response.

Response fields: api_version ("1.9.0", required) — Version of the API contract used to build this response.; generated_at (string · date-time, required) — UTC time when this response snapshot was generated.; licence (object, required) — Licence metadata for the distributed files.; licence.id ("CC-BY-4.0", required) — Stable identifier.; licence.url ("https://creativecommons.org/licenses/by/4.0/", required) — URL of the referenced resource.; licence.status ("final", required) — Current status value.; licence.effective ("2026-09-28", required) — Date the licence became effective.; licence.terms ("https://www.districtfacts.com/open-data/#terms", required) — URL of the DistrictFacts open-data terms.; licence.exceptions (object[], required) — Jurisdiction-specific licence exceptions; empty in the current contract.; attribution ("Source: DistrictFacts (districtfacts.com), compiled from public records listed in sources.", required) — Attribution text carried by the API response.; docs ("/data/v1/openapi.yaml", required) — Relative URL of the OpenAPI contract.; changelog ("/data/v1/changelog.json", required) — Relative URL of the API changelog.; version_policy ("Additive changes (new fields, files, states) ship within v1 without notice. Anything that removes, renames or changes the meaning of a field ships as v2 at a new path, with v1 kept for at least 6 months.", required) — Published compatibility policy for additive and breaking changes.; states[] (StateIndexEntry[], required) — Published jurisdiction entries in release order.; states[].state (string · nj | ct | pa | de | nh | md | ri | vt | dc | ga | mi, required) — Two-letter jurisdiction code.; states[].name (string, required) — Human-readable name.; states[].districts (integer, required) — Number of district records in the jurisdiction.; states[].api_url (string · uri-reference, required) — Relative URL of the JSON resource, or null when distribution is held.; states[].bulk_url (string · uri-reference, required) — Relative URL of the state NDJSON file, or null when distribution is held.; states[].bulk_bytes (integer, required) — Size of the bulk NDJSON file in bytes.; states[].districts_sha256 (string, required) — SHA-256 hash of the exact district-directory bytes.; states[].source_notice (string) — Attribution a source licence requires for this state's records (for example dc.gov's CC BY 3.0). Present only where one applies.; excluded[] (string[], required) — Explicit excluded record classes; current exclusions are listed in the index..

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))

Real response excerpt

{
  "api_version": "1.8.0",
  "states": [{
    "state": "de",
    "name": "Delaware",
    "districts": 43,
    "api_url": "/data/v1/de/districts.json",
    "bulk_url": "/data/v1/de/bulk.ndjson",
    "bulk_bytes": 20364509,
    "districts_sha256": "710804253a6047821fae7096a8bf412c39992f16c8a684ba9612f774c96d9cbf"
  }]
}

Excerpt. generated_at, licence, attribution, docs, changelog, version_policy, excluded, and other states are omitted.

GET /data/v1/jurisdictions.json

List website, API, bulk-file and licence status for every jurisdiction

Status codes: 200 (open and keyed) — Distribution status, hold reasons and recorded source-terms review dates; 304 (open and keyed) — ; 400 (open and keyed) — ; 401 (open and keyed) — ; 403 (open and keyed) — ; 404 (open and keyed) — ; 429 (open and keyed) — ; 500 (open and keyed) — ; 304 (keyed) — Keyed host response when If-None-Match matches the current ETag; 405 (keyed) — Method is not GET or HEAD.

Open-host response headers: Content-Type: application/json; charset=utf-8; Access-Control-Allow-Origin: *; X-Robots-Tag: noindex. Keyed-host response headers: Content-Type: application/json; charset=utf-8; Access-Control-Allow-Origin: *; X-Robots-Tag: noindex; Cache-Control: private, max-age=300; Vary: Authorization, X-API-Key, Accept-Encoding; ETag: weak tag built from the file SHA-256; X-DistrictFacts-Release: release identifier; X-Request-Id: request UUID; X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, X-RateLimit-Resource, RateLimit-Policy; Retry-After: present when the service can state a retry delay; Content-Length: response bytes on a 200 response.

Response fields: api_version ("1.9.0", required) — Version of the API contract used to build this response.; generated_at (string · date-time, required) — UTC time when this response snapshot was generated.; licence_terms ("https://www.districtfacts.com/open-data/#terms", required) — URL of the terms that apply to distributed files.; note ("A held jurisdiction's pages remain on districtfacts.com; held means its files are not offered for download or under CC BY.", required) — Context needed to interpret this object.; reviewed_at_note ("reviewed_at is the date of a source-terms review recorded in our files. Null means no dated review is recorded; the reason says whether the terms have been read.", required) — Explanation of how to read reviewed_at.; jurisdictions[] (JurisdictionStatus[], required) — Every public website jurisdiction, sorted by name.; jurisdictions[].state (string, required) — Two-letter jurisdiction code.; jurisdictions[].name (string, required) — Human-readable name.; jurisdictions[].web_status ("published", required) — Whether DistrictFacts pages are published.; jurisdictions[].web_url (string · uri, required) — Public jurisdiction page URL.; jurisdictions[].api_status (string · published | held, required) — Whether individual JSON files are distributed.; jurisdictions[].api_url (string | null, required) — Relative URL of the JSON resource, or null when distribution is held.; jurisdictions[].bulk_status (string · published | held, required) — Whether the bulk file is distributed.; jurisdictions[].bulk_url (string | null, required) — Relative URL of the state NDJSON file, or null when distribution is held.; jurisdictions[].license_status (string · CC-BY-4.0 | held, required) — CC BY 4.0 when distributed, otherwise held.; jurisdictions[].reason (string | null, required) — Reason files are held, or null when they are published.; jurisdictions[].reviewed_at (string | null, required) — Recorded source-terms review date, or null when no dated review is recorded..

curl

curl --fail --silent --show-error \
  https://www.districtfacts.com/data/v1/jurisdictions.json

curl

const response = await fetch("https://www.districtfacts.com/data/v1/jurisdictions.json");
if (!response.ok) throw new Error(`HTTP ${response.status}`);
interface JurisdictionsResponse {
  api_version: string;
  jurisdictions: Array<{ state: string; name: string; api_status: "published" | "held" }>;
}

const status = (await response.json()) as JurisdictionsResponse;
console.log(status.jurisdictions.length, "jurisdictions");

JavaScript

const response = await fetch("https://www.districtfacts.com/data/v1/jurisdictions.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/jurisdictions.json")
with urlopen(request, timeout=30) as response:
    data = json.load(response)
print(json.dumps(data, indent=2))

Example shape

{
  "api_version": "1.8.0",
  "jurisdictions": [{
    "state": "de", "name": "Delaware", "web_status": "published",
    "api_status": "published", "api_url": "/data/v1/de/districts.json",
    "bulk_status": "published", "bulk_url": "/data/v1/de/bulk.ndjson",
    "license_status": "CC-BY-4.0", "reason": null
  }]
}

Example shape. generated_at, licence_terms, note, reviewed_at_note, web_url, reviewed_at, and other jurisdictions are omitted.

GET /data/v1/{state}/districts.json

List districts available for a state

Status codes: 200 (open and keyed) — District directory; 304 (open and keyed) — ; 400 (open and keyed) — ; 401 (open and keyed) — ; 403 (open and keyed) — ; 404 (open and keyed) — ; 429 (open and keyed) — ; 500 (open and keyed) — ; 304 (keyed) — Keyed host response when If-None-Match matches the current ETag; 405 (keyed) — Method is not GET or HEAD.

Open-host response headers: Content-Type: application/json; charset=utf-8; Access-Control-Allow-Origin: *; X-Robots-Tag: noindex. Keyed-host response headers: Content-Type: application/json; charset=utf-8; Access-Control-Allow-Origin: *; X-Robots-Tag: noindex; Cache-Control: private, max-age=300; Vary: Authorization, X-API-Key, Accept-Encoding; ETag: weak tag built from the file SHA-256; X-DistrictFacts-Release: release identifier; X-Request-Id: request UUID; X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, X-RateLimit-Resource, RateLimit-Policy; Retry-After: present when the service can state a retry delay; Content-Length: response bytes on a 200 response.

Response fields: leaid (string | null, required) — NCES LEAID; null only for a NY state-only identity with district_key.; district_key (string) — Stable DistrictFacts district identity when supplied.; slug (string, required) — Stable URL segment for the district.; name (string, required) — Human-readable name.; page_url (string · uri, required) — Public DistrictFacts page for this district.; api_url (string · uri-reference, required) — Relative URL of the JSON resource, or null when distribution is held.; sha256 (string, required) — SHA-256 hash of the exact file bytes.; bytes (integer, required) — File size in bytes..

curl

curl --fail --silent --show-error \
  https://www.districtfacts.com/data/v1/de/districts.json

curl

const response = await fetch("https://www.districtfacts.com/data/v1/de/districts.json");
if (!response.ok) throw new Error(`HTTP ${response.status}`);
interface DistrictDirectoryEntry {
  slug: string;
  name: string;
  leaid: string | null;
  api_url: string;
}

const districts = (await response.json()) as DistrictDirectoryEntry[];
console.log(districts.length, "districts");

JavaScript

const response = await fetch("https://www.districtfacts.com/data/v1/de/districts.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/de/districts.json")
with urlopen(request, timeout=30) as response:
    data = json.load(response)
print(json.dumps(data, indent=2))

Excerpt of one directory entry

[{ "slug": "capital-school-district", "name": "Capital School District", "leaid": "1000190", "page_url": "https://www.districtfacts.com/de/capital-school-district/", "api_url": "/data/v1/de/districts/capital-school-district.json", "sha256": "f53a2c4796667e78c01257a50cb3c10d5d0e60027627b8577b57f9bb18663f28", "bytes": 862805 }]

Excerpt. The other 42 directory entries are omitted.

GET /data/v1/{state}/bulk.ndjson

Get every district record in a state as newline-delimited JSON Records are in slug order. Each line is byte-identical to the content of that district's individual JSON file, and the file is newline-terminated.

Status codes: 200 (open and keyed) — One ApiDistrict JSON object per line; 302 (open and keyed) — Only on the keyed host; redirects to a signed bulk download URL valid for 600 seconds.; 400 (open and keyed) — ; 401 (open and keyed) — ; 403 (open and keyed) — ; 404 (open and keyed) — ; 429 (open and keyed) — ; 500 (open and keyed) — ; 302 (keyed) — Keyed host redirect to a short-lived signed download URL; 405 (keyed) — Method is not GET or HEAD.

Open-host response headers: Content-Type: application/x-ndjson; charset=utf-8; Access-Control-Allow-Origin: *; X-Robots-Tag: noindex. Keyed-host response headers: Content-Type: application/x-ndjson; charset=utf-8; Access-Control-Allow-Origin: *; X-Robots-Tag: noindex; Cache-Control: private, max-age=300; Vary: Authorization, X-API-Key, Accept-Encoding; ETag: weak tag built from the file SHA-256; X-DistrictFacts-Release: release identifier; X-Request-Id: request UUID; X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, X-RateLimit-Resource, RateLimit-Policy; Retry-After: present when the service can state a retry delay; Location: signed download URL on a 302 GET; Cache-Control: no-store on a 302 GET; Content-Length: bulk bytes on a 200 HEAD.

Response fields: .

curl

curl --fail --silent --show-error \
  https://www.districtfacts.com/data/v1/de/bulk.ndjson \
  -o bulk.ndjson
head -n 1 bulk.ndjson

curl

const response = await fetch("https://www.districtfacts.com/data/v1/de/bulk.ndjson");
if (!response.ok) throw new Error(`HTTP ${response.status}`);
interface BulkDistrictRecord {
  slug: string;
  name: string;
  measures: Array<{ status: "published" | "withheld" | "not_collected"; key: string }>;
}

const reader = response.body?.getReader();
if (!reader) throw new Error("ReadableStream not supported");
const decoder = new TextDecoder();
let buffer = "";
let count = 0;
while (true) {
  const { done, value } = await reader.read();
  buffer += decoder.decode(value ?? new Uint8Array(), { stream: !done });
  const lines = buffer.split("\n");
  buffer = done ? "" : lines.pop() ?? "";
  for (const line of lines) {
    if (!line.trim()) continue;
    const record = JSON.parse(line) as BulkDistrictRecord;
    count += 1;
    if (count === 1) console.log(record.name, `${record.measures.length} measures`);
  }
  if (done) break;
}
console.log(count, "records");

JavaScript

const response = await fetch("https://www.districtfacts.com/data/v1/de/bulk.ndjson");
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const reader = response.body.getReader();
const decoder = new TextDecoder();
let buffer = "";
let count = 0;
while (true) {
  const { done, value } = await reader.read();
  buffer += decoder.decode(value ?? new Uint8Array(), { stream: !done });
  const lines = buffer.split("\n");
  buffer = done ? "" : lines.pop();
  for (const line of lines) {
    if (!line.trim()) continue;
    const record = JSON.parse(line); // One district record per line.
    count += 1;
    if (count === 1) console.log(record.slug, record.name);
  }
  if (done) break;
}
console.log(count, "records");

Python

import json
from urllib.request import Request, urlopen

request = Request("https://www.districtfacts.com/data/v1/de/bulk.ndjson")
count = 0
with urlopen(request, timeout=30) as response:
    for line in response:  # One district record per line.
        if not line.strip():
            continue
        record = json.loads(line)
        count += 1
        if count == 1:
            print(record["slug"], record["name"])
print(count, "records")

Excerpt of one record

{"api_version": "1.8.0","state": "DE","leaid": "1000190","slug": "capital-school-district","name": "Capital School District","generated_at": "2026-09-25T12:00:00.000Z","page_url": "https://www.districtfacts.com/de/capital-school-district/","licence_status": "final","measures": [{"status": "published","key": "chronic_absence_pct","period": "2020-2021","value": 39.26,"unit": "percent","source_id": "de-attendance","locator": "schoolyear=2021; All Students; pctstudentschronicallyabsent; district 13, school 0"}]}

Excerpt. attribution, sources, schools, line_items, other measures, and the selected measure’s label, category, and definition are omitted.

GET /data/v1/{state}/districts/{slug}.json

Get one district and its published, withheld, and not-collected claims

Status codes: 200 (open and keyed) — Projected district record; 304 (open and keyed) — ; 400 (open and keyed) — ; 401 (open and keyed) — ; 403 (open and keyed) — ; 404 (open and keyed) — ; 429 (open and keyed) — ; 500 (open and keyed) — ; 304 (keyed) — Keyed host response when If-None-Match matches the current ETag; 405 (keyed) — Method is not GET or HEAD.

Open-host response headers: Content-Type: application/json; charset=utf-8; Access-Control-Allow-Origin: *; X-Robots-Tag: noindex. Keyed-host response headers: Content-Type: application/json; charset=utf-8; Access-Control-Allow-Origin: *; X-Robots-Tag: noindex; Cache-Control: private, max-age=300; Vary: Authorization, X-API-Key, Accept-Encoding; ETag: weak tag built from the file SHA-256; X-DistrictFacts-Release: release identifier; X-Request-Id: request UUID; X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset, X-RateLimit-Resource, RateLimit-Policy; Retry-After: present when the service can state a retry delay; Content-Length: response bytes on a 200 response.

Response fields: api_version ("1.9.0", required) — Version of the API contract used to build this response.; state (string · NJ | CT | PA | DE | NH | MD | RI | VT | DC | GA | MI, required) — Two-letter jurisdiction code.; leaid (string | null, required) — NCES LEAID; null only for a NY state-only identity with district_key.; district_key (string) — Stable DistrictFacts district identity when supplied.; slug (string, required) — Stable URL segment for the district.; name (string, required) — Human-readable name.; state_district_id (string) — Exact state agency district identifier where provided.; coverage_note (string) — Explicit limits of this export versus website coverage.; generated_at (string · date-time, required) — UTC time when this response snapshot was generated.; page_url (string · uri, required) — Public DistrictFacts page for this district.; licence_status (string · final | under_review, required) — Licence status for this district record.; attribution ("Source: DistrictFacts (districtfacts.com), compiled from public records listed in sources.", required) — Attribution text carried by the API response.; sources (object, required) — Only sources referenced by this district's cells, school cells, line items, and notices.; sources.*.id (string, required) — Stable identifier.; sources.*.url (string · uri, required) — URL of the referenced resource.; sources.*.sha256 (string, required) — SHA-256 hash of the exact file bytes.; sources.*.locator (string, required) — Exact row, cell, filter, or calculation location within the source.; sources.*.retrieved_at (string · date-time, required) — UTC time when DistrictFacts retrieved the source.; sources.*.source_host (string, required) — Hostname of the official source URL.; sources.*.citation (object) — Optional agency citation, included on every Michigan source; keep it with the source URL and link when reusing a figure.; measures[] (Cell[], required) — Published, withheld, and not-collected district cells.; measures[].status ("not_collected", required) — Current status value.; measures[].key (string, required) — Stable machine-readable measure key.; measures[].label (string, required) — Human-readable measure or row label.; measures[].category (string · finance | students | staff | outcomes | programs | climate | funding | fiscal, required) — Measure category used to group related values.; measures[].period (string) — Reporting period the value describes.; measures[].definition (string) — Scope and meaning of the measure as published.; measures[].value (number) — Exact stored value; monetary units remain integer cents.; measures[].unit (string) — Unit used by the exact stored value.; measures[].source_id (string) — Key in the district record's sources registry.; measures[].locator (string) — Exact row, cell, filter, or calculation location within the source.; measures[].position_class ("single_position") — Identifies a published leadership salary held by one position.; measures[].reason (string · agency_suppressed | failed_distribution_gate | definition_not_comparable | source_unverified | superseded_pending_review | privacy_review) — Reason files are held, or null when they are published.; measures[].note (string) — Context needed to interpret this object.; measures[].capability (string · finance_detail | funding_taxes | staffing | outcomes | students | programs | climate | fiscal_transparency | trends | comparisons | schools) — Data capability that was not collected.; schools[] (School[], required) — Schools and their separately scoped measures.; schools[].code (string, required) — Source-system code for the school or line item.; schools[].name (string, required) — Human-readable name.; schools[].grades (string, required) — Grade span reported for the school.; schools[].page_url (string · uri, required) — Public DistrictFacts page for this district.; schools[].measures (SchoolCell[], required) — Published, withheld, and not-collected district cells.; schools[].notice (Notice) — Context that changes how the record's figures should be read.; line_items[] (LineItem[], required) — Source-linked financial or fiscal line items.; line_items[].code (string, required) — Source-system code for the school or line item.; line_items[].label (string, required) — Human-readable measure or row label.; line_items[].category (string, required) — Measure category used to group related values.; line_items[].category_code (string, required) — Source-system category code for the line item.; line_items[].location (string, required) — Source-reported location for the line item.; line_items[].period (string, required) — Reporting period the value describes.; line_items[].aggregate (boolean, required) — Whether DistrictFacts summed source rows to produce this line.; line_items[].general_fund_cents (integer | null, required) — General-fund amount in integer cents, or null.; line_items[].grants_revolving_cents (integer | null, required) — Grants or revolving-fund amount in integer cents, or null.; line_items[].total_cents (integer | null, required) — Total amount in integer cents, or null.; line_items[].per_pupil_cents (integer | null, required) — Per-pupil amount in integer cents, or null.; line_items[].locator (string, required) — Exact row, cell, filter, or calculation location within the source.; line_items[].source_id (string, required) — Key in the district record's sources registry.; notice (Notice) — Context that changes how the record's figures should be read.; notice.text (string) — Notice text that changes how the record should be read.; notice.href (string) — DistrictFacts page that gives the notice context.; notice.link_label (string) — Visible label for the notice link.; notice.locator (string) — Exact row, cell, filter, or calculation location within the source.; notice.source_id (string) — Key in the district record's sources registry.; school_history_limits[] (SchoolHistoryLimit[]) — Added in 1.3.0. Present only where the file carries fewer periods of a school-level series than the website shows (Georgia school discipline, the five most recent school years).; school_history_limits[].measures (string) — Key pattern of the school measures the limit applies to, for example school_discipline_*.; school_history_limits[].periods (string[]) — The periods the file carries for those measures, oldest first.; school_history_limits[].note (string) — Context needed to interpret this object..

curl

curl --fail --silent --show-error \
  https://www.districtfacts.com/data/v1/de/districts/capital-school-district.json

curl

const response = await fetch("https://www.districtfacts.com/data/v1/de/districts/capital-school-district.json");
if (!response.ok) throw new Error(`HTTP ${response.status}`);
interface DistrictRecord {
  api_version: string;
  state: string;
  leaid: string | null;
  slug: string;
  name: string;
  measures: Array<{ status: "published" | "withheld" | "not_collected"; key: string }>;
  schools: Array<{ code: string; name: string }>;
  line_items: Array<{ code: string; label: string }>;
  licence_status: "final" | "under_review";
}

const district = (await response.json()) as DistrictRecord;
console.log(district.name, `${district.measures.length} measures`);

JavaScript

const response = await fetch("https://www.districtfacts.com/data/v1/de/districts/capital-school-district.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/de/districts/capital-school-district.json")
with urlopen(request, timeout=30) as response:
    data = json.load(response)
print(json.dumps(data, indent=2))

Real response excerpt

{
  "api_version": "1.8.0",
  "state": "DE",
  "leaid": "1000190",
  "slug": "capital-school-district",
  "name": "Capital School District",
  "generated_at": "2026-09-25T12:00:00.000Z",
  "page_url": "https://www.districtfacts.com/de/capital-school-district/",
  "licence_status": "final",
  "measures": [{
    "status": "published",
    "key": "chronic_absence_pct",
    "period": "2020-2021",
    "value": 39.26,
    "unit": "percent",
    "source_id": "de-attendance",
    "locator": "schoolyear=2021; All Students; pctstudentschronicallyabsent; district 13, school 0"
  }]
}

Excerpt. attribution, sources, schools, line_items, other measures, and the selected measure’s label, category, and definition are omitted.

Developer documentation