{
  "title": "Provider directory scoreboard",
  "note": "Six metrics with a current baseline, each reproducible from public data. Stated so progress is arguable rather than felt. Recompute them against the next release with analysis/primer_scoreboard.py.",
  "release_date": "2026-08-20",
  "generated_at": "2026-08-21T13:03:14+00:00",
  "commit_sha": "163c6bc2ede9092f966d19be1975b2d30789cdd9",
  "metrics": [
    {
      "key": "endpoint-attribution",
      "label": "Endpoint attribution",
      "question": "Does the directory say who an endpoint belongs to?",
      "value": 14.7,
      "unit": "%",
      "detail": "16,262 of 110,973 FHIR REST endpoints name a managing organization.",
      "headroom": "79.9% using only public vendor files that exist today.",
      "finding": "endpoint-org-linkage"
    },
    {
      "key": "partof-resolution",
      "label": "partOf resolution",
      "question": "Does the organization hierarchy point at anything?",
      "value": 100.0,
      "unit": "%",
      "detail": "140,017 references to 43,551 distinct parent organizations. 140,017 resolve to a record in the export.",
      "headroom": "Publish the parents, or drop the field.",
      "finding": null
    },
    {
      "key": "organization-typing",
      "label": "Organization typing",
      "question": "Can a consumer tell entities from tax records?",
      "value": 50.0,
      "unit": "% untyped",
      "detail": "2,199,519 of 4,402,671 Organization records are tax-entity records carrying free text rather than a coding, against 2,202,028 provider records.",
      "headroom": "Give them a real code so they can be filtered.",
      "finding": null
    },
    {
      "key": "endpoint-usability",
      "label": "Endpoint usability",
      "question": "How many endpoints can software actually query?",
      "value": 9.8,
      "unit": "%",
      "detail": "110,973 of 1,128,169 Endpoint resources are FHIR REST. The rest are Direct messaging addresses.",
      "headroom": "Not a defect. It is the right denominator to publish.",
      "finding": "endpoint-url-validity"
    },
    {
      "key": "affiliation-coverage",
      "label": "Affiliation coverage",
      "question": "Does the directory say where a clinician works?",
      "value": 43.7,
      "unit": "% have one",
      "detail": "100,918 of 230,837 active Pennsylvania practitioners carry a PractitionerRole. Coverage is uneven by profession, from 82.0% of advanced practice to 4.2% of pharmacy providers.",
      "headroom": "Publish role provenance so absence can be read.",
      "finding": "role-gap-composition"
    },
    {
      "key": "brand-coverage",
      "label": "Brand coverage",
      "question": "Can a patient's hospital be identified as itself?",
      "value": 0,
      "unit": "%",
      "detail": "No brand or health-system layer exists in the directory. Nothing states that an organization belongs to a system a patient would recognize.",
      "headroom": "Vendor User Access Brands files are already public.",
      "finding": "vendor-endpoint-attribution"
    }
  ]
}