Available Endpoints

GET /cds-services

Lists all available CDS services.

POST /cds-services

Routes the hook request to appropriate hook handler.

POST /cds-services/patient-assessment

Provides routine check recommendations based on patient data.

POST /cds-services/order-assistant

Informs about medication when selecting orders.

POST /cds-services/order-review

Reviews medication orders prior to signature.

GET /health

Returns the status of the service.

Testing Instructions

CDS Hooks Sandbox

To test this service in the CDS Hooks Sandbox:

  1. Go to https://sandbox.cds-hooks.org/
  2. Click on "Settings" in the top right corner
  3. Click "Add CDS Services"
  4. Enter https://cds-service.htdhealth.com/cds-services as the discovery endpoint
  5. Click "Save"

To use different FHIR servers and display different resources in the SMART app:

  1. Click on "Settings" in the top right corner
  2. Click "Change FHIR Server"
  3. Change the default server URL (https://launch.smarthealthit.org/v/r2/fhir) to https://r4.smarthealthit.org
  4. Click "Next" to update the FHIR server.
  5. Select a patient from the list.
  6. Click "Save" to update the patient.
  7. Using a different FHIR server allows you to access additional resources and test the service with a wider range of clinical data in the practitioner app.

To test specific hooks:

  • Patient-View Hook: View the patient in the Patient View tab. The service will provide recommended check-ups based on patient demographics in the form of a Routine Health Assessment card.
  • Order-Select Hook: Begin the process of ordering a medication in the Rx View tab. Start writing in the autocomplete input. Select the type, the dosage, and then the formulation. The service will provide relevant information about the selected medication in the form of a Order Selection Review card.
  • Order-Sign Hook: When signing orders in the Rx Sign tab, the service will provide a final check for potential issues in the form of a Pre-Signature Order Review card.

Epic Integration

To test this service in Epic:

  1. Contact Epic to acquire access to vendor services account
  2. Register this CDS Service in your Epic environment
  3. Test the service in Hyperspace by accessing patient records and medication workflows

For detailed integration instructions with Epic, please contact our support team.