Skip to main content

SMART Health IT Sandbox

The SMART Health IT sandbox (launch.smarthealthit.org) is a free, public SMART on FHIR test environment. No credentials required.

Configure for sandbox testing​

application-smart.yml
smart:
  epic:
    client-id:     "whatever"         # sandbox accepts any value
    redirect-uri:  "http://localhost:8080/callback"
    scopes:        "launch openid fhirUser patient/Patient.rs patient/Condition.rs"
    launch-url:    "https://launch.smarthealthit.org/v/r4/sim/eyJhIjoiMSJ9/fhir"

Run the integration test​

mvn test -Psmart

SmartHealthSandboxIT runs through the full launch flow against the sandbox:

  1. Initiates a launch with the sandbox ISS
  2. Handles the simulated authorization (sandbox auto-approves)
  3. Exchanges for tokens
  4. Makes FHIR calls for Patient, Conditions, Medications
  5. Verifies all responses parse correctly

LaunchPad​

The SMART Health IT LaunchPad (launch.smarthealthit.org) lets you manually test a launch:

  1. Go to https://launch.smarthealthit.org
  2. Enter your app's launch URL: http://localhost:8080/launch
  3. Select a test patient
  4. Click Launch — your running application opens in a new tab

Next: Epic Sandbox →