Versioning

What additive and breaking DistrictFacts API changes mean for clients.

Published 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.

Host migration is separate from schema versioning

ADR-0005 says the open www files stay for six months after the keyed launch, with Deprecation and Sunset headers at launch. That keyed public launch has not happened; the open host remains the working default today.

Developer documentation