Skip to main content
Inferno on HealthIT.gov is for demonstration only. Not for use with is not for use with sensitive data or Protected Health Information (PHI). Data periodically removed.

Service Base URL Test Kit

Test Kit Version: 0.11.1
Maturity: Medium
Endpoint Publication

The Service Base URL Test Kit provides a set of tests that verify conformance of Service Base URL publications to data format requirements as described in Conditions and Maintenance of Certification - Application programming interfaces and the ONC HTI-1 Final Rule. Please review the Application Programming Interfaces Certification Companion Guide for additional guidance. This Test Kit is provided as a tool to help developers identify potential issues or problems with the structure of their Service Base URL publication. Test failures do not necessarily indicate non-conformance to the Conditions and Maintenance of Certification. Use of these tests is not required for participants of the ONC Health IT Certification Program. Please provide feedback on these tests by reporting an issue in GitHub, or by reaching out to the team on the Inferno FHIR Zulip channel.

This Test Kit specifically targets requirements provided within the Conditions and Maintenance of Certification. Testing for the related SMART User-access Brands and Endpoints specification is provided separately within the SMART App Launch Test Kit.

Relevant requirements from the Conditions and Maintenance of Certification - Application programming interfaces:

Service Base URL publication:

For all Health IT Modules certified to § 170.315(g)(10), a Certified API Developer must publish, at no charge, the service base URLs and related organization details that can be used by patients to access their electronic health information, by December 31, 2024. This includes all customers regardless of whether the Health IT Modules certified to § 170.315(g)(10) are centrally managed by the Certified API Developer or locally deployed by an API Information Source. These service base URLs and organization details must conform to the following:

  • Service base URLs must be publicly published in Endpoint resource format according to the standard adopted in § 170.215(a) (FHIR v4.0.1).
  • Organization details for each service base URL must be publicly published in Organization resource format according to the standard adopted in § 170.215(a) (FHIR v4.0.1). Each Organization resource must contain:
    • A reference, in the Organization endpoint element, to the Endpoint resources containing service base URLs managed by this organization.
    • The organization’s name, location, and facility identifier.
  • Endpoint and Organization resources must be:
    • Collected into a Bundle resource formatted according to the standard adopted in § 170.215(a) (FHIR v4.0.1) for publication;
    • and Reviewed quarterly and, as necessary, updated.

Providing Feedback and Reporting Issues

We welcome feedback on the tests, including but not limited to the following areas:

  • Validation logic, such as potential bugs, lax checks, and unexpected failures.
  • Requirements coverage, such as requirements that have been missed, tests that necessitate features that the IG does not require, or other issues with the interpretation of the IG’s requirements.
  • User experience, such as confusing or missing information in the test UI.

Please report any issues with this set of tests in the issues section of the source code repository.

Start Testing

Create Test Session
Your Recent Sessions

    No recent test sessions have been run from this browser.

    If you run tests using Inferno on HealthIT.gov, links to the 5 most recent test sessions will be shown here.