{
  "id": "schools",
  "name": "Schools",
  "description": "Education identity graph and public school, private school, postsecondary, civil-rights, and geographic data.",
  "kind": "api",
  "audience": "public",
  "access": "open",
  "auth": "No authentication is required for documented public read operations.",
  "lifecycle": "active",
  "health": "degraded",
  "canonicalUrl": "https://schools.datasourceapi.com",
  "aliases": [],
  "docsUrl": "https://schools.datasourceapi.com/api/v1/docs",
  "docsMediaType": "text/html",
  "openapiUrl": "https://schools.datasourceapi.com/openapi.yaml",
  "openapiMediaType": "application/yaml",
  "statusUrl": "https://schools.datasourceapi.com/api/v1/status",
  "statusMediaType": "application/json",
  "repository": "https://github.com/coopalliance/cca-schools",
  "serviceBinding": {
    "supported": true,
    "description": "Approved fleet services can query school metadata through a service binding."
  },
  "provenance": [
    {
      "name": "National Center for Education Statistics",
      "description": "CCD, PSS, IPEDS, College Scorecard, CRDC, EDFacts, and EDGE datasets.",
      "url": "https://nces.ed.gov/"
    },
    {
      "name": "Education authorities",
      "description": "State and selected international education authority records."
    }
  ],
  "freshness": {
    "cadence": "Daily federal, six-hour state, and 30-minute automation schedules.",
    "lastVerified": "2026-09-03"
  },
  "capabilities": [
    "education",
    "identity-resolution",
    "school-search",
    "school-statistics"
  ],
  "examples": [
    {
      "label": "Service status",
      "description": "Inspect source coverage and ingestion health.",
      "method": "GET",
      "url": "https://schools.datasourceapi.com/api/v1/status"
    }
  ],
  "operations": [
    {
      "operationId": "getSchoolsStatus",
      "summary": "Get school data coverage and service health.",
      "method": "GET",
      "path": "/api/v1/status"
    }
  ],
  "agentReadiness": {
    "level": "partial",
    "score": 58,
    "summary": "OpenAPI and docs are published, but the last status audit reported critical CCD and IPEDS coverage gaps."
  }
}