Service Base URL Publication

Requirement. Under §170.404(b)(2), a Certified API Developer must publish the service base URLs (FHIR endpoints) for all Health IT Modules certified to §170.315(g)(10) that patients can use to access their EHI — for all customers, whether centrally managed or locally deployed — in a machine-readable format at no charge.

1. Machine-Readable Endpoint File

The authoritative, machine-readable list is published as an HL7® FHIR® R4 Bundle of Endpoint and Organization resources at a stable, public, no-charge URL:

https://retinex.ai/docs/service-base-urls.json

Open the machine-readable Endpoint Bundle →

2. Service Base URL(s)

Retinex Health IT Modules are centrally managed by Retinex, Inc.; a single multi-tenant FHIR service base URL serves all customers:

Because Retinex centrally manages all §170.315(g)(10) modules, customers are tenants of this single service base URL rather than separate locally-deployed endpoints. Should any customer be locally deployed in the future, its service base URL will be added to the machine-readable file above.

3. Endpoint Resource Format

Each endpoint follows the HL7 FHIR Endpoint resource (as recommended in the §170.404 Application Programming Interfaces CCG):

{
  "resourceType": "Endpoint",
  "id": "retinex-smart-r4",
  "status": "active",
  "connectionType": {
    "system": "http://terminology.hl7.org/CodeSystem/endpoint-connection-type",
    "code": "hl7-fhir-rest"
  },
  "name": "Retinex Health — FHIR R4 Patient Access API (g)(10)",
  "managingOrganization": { "reference": "Organization/retinex-inc", "display": "Retinex, Inc." },
  "payloadType": [{ "coding": [{ "code": "any" }] }],
  "payloadMimeType": ["application/fhir+json"],
  "address": "https://retinex-apim.azure-api.net/smart"
}

4. Discovery from the Base URL

From the service base URL, applications discover authorization and capabilities:

• GET https://retinex-apim.azure-api.net/smart/.well-known/smart-configuration — SMART/OAuth endpoints (see SMART Authorization).
• GET https://retinex-apim.azure-api.net/smart/metadata — FHIR CapabilityStatement.

5. Terms of Access

• The endpoint file is published at no charge and requires no authentication to read.
• It is updated whenever a service base URL is added, changed, or retired.
• This satisfies the requirement that service base URLs be published by December 31, 2024 in a standardized, machine-readable FHIR format for all §170.315(g)(10) Health IT Modules.

6. Change Log