Compliance API

Endpoint — meta

GET /api/v1/compliance/meta

Health check + dataset metadata. Use this as your first request when wiring up a new integration.

Example

curl -H "Authorization: Bearer $TOKEN" https://homeschoolfox.com/api/v1/compliance/meta
{
  "data": {
    "state_count": 51,
    "schema_version": "1",
    "latest_snapshot_at": "2026-05-12T20:40:02-05:00"
  },
  "meta": { "api_version": "v1" }
}

Fields

  • state_count — number of jurisdictions currently exposed (51 = 50 states + DC)
  • schema_version — JSON Schema major version for the state YAML payload shape
  • latest_snapshot_at — ISO 8601 timestamp of the most recent compliance_snapshots row across any resource (useful as a "anything changed?" probe)