{
  "slug": "endpoint-url-validity",
  "title": "Endpoint URL validity + machine-readable share",
  "hypotheses": [
    "H28"
  ],
  "status": "published",
  "release_date": "2026-05-08",
  "generated_at": "2026-05-09T00:15:14+00:00",
  "methodology_version": "0.6.0-draft",
  "commit_sha": "bebebde",
  "headline": "Of 1,360,585 Endpoint resources in the 2026-05-08 NDH bulk export, only 114,071 (8.4%) are machine-readable FHIR REST URLs an integrator can GET. The remaining 1,246,514 (91.6%) are Direct Trust HISP addresses (clinical messaging, not a queryable API), and 0 use other connection types. The 8.4% machine-readable share is the right denominator for any \"find the FHIR endpoint for this provider\" feature built on top of NDH.",
  "numerator": 114071,
  "denominator": 1360585,
  "chart": {
    "type": "bar",
    "unit": "count",
    "data": [
      {
        "label": "FHIR REST (machine-readable)",
        "value": 114071
      },
      {
        "label": "Direct Trust messaging",
        "value": 1246514
      },
      {
        "label": "Other / unspecified",
        "value": 0
      }
    ]
  },
  "notes": "NDH ships two distinct connectionType.code values that share an Endpoint shape: hl7-fhir-rest (FHIR REST API URLs) and direct-project (Direct Trust HISP messaging addresses, of the form provider@hisp.example.com). Both are valuable but solve different problems. Of the 114,071 hl7-fhir-rest endpoints, 100% have a valid https:// URL \u2014 there is no http:// or malformed URL noise in this slice. 98,819 are flagged status=active. Crawler liveness (/findings/endpoint-liveness, H1-H5) probes the active subset. For consumers wiring 'find FHIR endpoint by NPI' \u2014 the right denominator is the 114,071 hl7-fhir-rest endpoints, NOT the 1,360,585 total resource count. This was a non-obvious cliff in the data quality dashboard until H28 surfaced it."
}