Data model

Use district identities, measures, periods, units, source hashes, and missing values correctly.

Keep a number with its identity, period, unit, definition, status and source. API paths use lowercase jurisdiction codes; records use uppercase state codes. leaid is the seven-digit NCES identifier and may be null. district_key is optional. Most records are identified by a non-null LEAID; when LEAID is null, the schema requires an explicit New York BEDS district_key. Never invent an NCES ID.

Missing values

A published cell has a value. A withheld or not-collected cell has no value, and neither is zero. Money stays in integer cents. Resolve each cell's source_id to its official URL, SHA-256 source hash and locator.

Releases

A changed record hash can mean a correction, definition change, format release or new reporting period. There is no change feed or webhook.

Developer documentation