{"activeVersionTag":"latest","latestAvailableVersionTag":"latest","collection":{"info":{"_postman_id":"4f1469f0-f1da-402b-86b7-094cbe0ec966","name":"Darena Health","description":"Welcome to the Darena Health (formerly MeldRx) documentation. Darena Health is a FHIR-first healthcare platform designed to address a wide range of use cases in the healthcare ecosystem. This documentation provides comprehensive guidance on how to interact with Darena Health through both the Darena Health App and Darena Health APIs. Whether you are using the app’s intuitive interface or integrating with the platform programmatically via APIs, this guide will help you unlock the full potential of the platform.\n\n## How to Use This Guide\n\nTo get the most out of this documentation, we recommend starting with the **Getting Started** section, which provides an essential overview of Darena Health's core concepts and features. This foundational knowledge will help you understand how the platform operates and how to navigate its various functionalities.\n\nOnce familiar with the basics, you can explore the specific use case relevant to your needs. Darena Health supports multiple use cases, and this guide is structured to let you dive into the areas most important to your implementation, whether you're using the Darena Health app or the APIs.\n\n# Getting Started\n\n## Darena Health URLs\n\nBelow are the essential URLs you'll need to interact with the platform, whether you're using the Darena Health App (aka the app) or the Darena Health APIs.\n\n- **Darena Health App URL:** [https://app.meldrx.com](https://app.meldrx.com)  \n    Access the Darena Health app directly through this link.\n    \n- **Darena Health App Redirect URL:** [https://app.meldrx.com/sof-callback](https://app.meldrx.com/sof-callback)  \n    This is the callback URL used for launching Darena Health from within an EHR system.\n    \n- **Darena Health API Base URL:** [https://app.meldrx.com/api](https://app.meldrx.com/api)  \n    Use this URL as the base for accessing all API endpoints.\n    \n- **Darena Health Worskpace FHIR Base URL:** [https://app.meldrx.com/api/fhir/{WorkspaceSlug}](https://app.meldrx.com/connect/token)  \n    This is the base URL for accessing FHIR features of a workspace\n    \n- **Darena Health Token URL:** [https://app.meldrx.com/connect/token](https://app.meldrx.com/connect/token)  \n    This is the URL for obtaining authentication tokens required for API access.\n    \n- **Darena Health Directory URL:** [https://app.meldrx.com/directory](https://hub.meldrx.com)  \n    Access the Darena Health Directory for list of workspaces.\n    \n- **Darena Health API Swagger URL**: [https://app.meldrx.com/swagger](https://app.meldrx.com/swagger)\n    \n- **MyMIPSScore Base URL**: [https://app.meldrx.com/mms-api](https://app.meldrx.com/mms-api)\n    \n\n## Darena Health Core Concepts\n\nDarena Health is built around two core concepts: **Workspaces** and **Apps**.\n\n- **Workspace**: A workspace is an isolated instance of Darena Health APIs, designed with its own user management and data isolation. Every workspace is FHIR-ready by default, but it can also expose multiple other APIs to suit various use cases.\n    \n- **Apps**: Apps are how users interact with workspaces using APIs. Developers can create and provision apps that allow specific access to different workspaces.\n    \n\nDarena Health is structured around the following hierarchy:\n\n- **Developer Account:** This is the top-level account tied to a subscription. The subscription type determines the features available to the developer acccount. A developer account has team members with roles.\n    \n- **Apps**: Developer account team members can register and manage apps in their accounts. These apps can be used to access workspaces.\n    \n- **Workspaces:** Each developer account **may** have 1 or multiple workspaces. These workspaces can be for the developer organization themselves or for reselling.\n    \n- **Workspace Users:** Each workspace has its own set of users with roles specific to that workspace.\n    \n\n<img src=\"https://content.pstmn.io/0852be6d-41e7-4a9d-b5e9-1e149aad4202/aW1hZ2UgMTMucG5n\">\n\nA **Developer Account** can be managed by various types of organizations. This could be an **EHR vendor** managing multiple workspaces for their customers, or it could be an **organization** such as a healthcare system managing workspaces for different projects or departments. Each developer account is flexible to accommodate diverse use cases, whether for internal use or reselling to external users.\n\n# Workspace Permissions\n\nWorkspace permissions are determined by both the user and the app being used to access the workspace. Permissions fall into two broad categories:\n\n- **App Permissions**: These are permissions assigned directly to \"System Apps.\" System apps run without a user, making it important to assign these permissions carefully. A system app can be added to the workspace by a team member or workspace user. The scope of the app’s access is determined by the permissions (scopes) assigned to it.\n    \n- **User Permissions**: User permissions are assigned to individuals who access the workspace through \"User based Apps\". The level of access a user has within a workspace depends on the role or permissions granted to them.\n    \n\nNOTE: Developer team members can access all workspaces in that subscription and data based on their assigned permissions within the team. Workspace users, however, have access to only the features and data within their assigned workspace, according to the permissions set for them in that workspace.\n\n# Darena Health Use Cases\n\nDarena Health supports a variety of healthcare workflows and use cases.\n\n## Darena Health Solutions\n\nPlug & Play or complete solutions ready to use or be integrated with other solutions.\n\n1. Cures Act Regulatory APIs - EHRs\n    \n2. Consumer Mediated Exchange based Data Aggregation (coming soon)\n    \n3. MIPS APIs for EHR integration\n    \n4. Clinical Decision Support\n    \n\n## Darena Health For App Developers\n\n1. Explore workspaces for free\n    \n2. Develop and Sell Patient apps to Darena Health Users\n    \n3. Provider App Supplier Program\n    \n4. Darena Health White Labeled Custom Solutions\n    \n\n# Darena Health APIs for Cures Act Compliance\n\nAre you a patient app developer looking to connect to a healthcare provider that is using Darena Health? Darena Health provides FHIR API services to multiple EHRs, allowing your app to seamlessly integrate with all of them through a single connection. Follow these simple steps to get started with patient access—no approval required for any of the steps.\n\nWatch our [video tutorial here](https://www.youtube.com/watch?v=-K2qJvUcFcA) for more details, and follow the steps below to begin your integration journey.\n\n#### Step 1: Create a Free Darena Health Developer Account\n\nTo get started, create a **free developer account** by visiting the [Darena Health app](https://app.meldrx.com).\n\n#### Step 2: Register Your Patient App\n\nAfter verifying your email, you will be able to register your app to receive your App Id/Client Id.\n\n#### Step 3: Provision a Free Sandbox Workspace\n\nYou can provision a free sandbox workspace to start testing your app. Sandbox Workspaces are FHIR APIs that work exactly same as the Darena Health Live FHIR APIs. The sandbox allows you to upload demo data only (no PHI / EHI allowed) and verify that your app integrates smoothly with the APIs.\n\n#### Step 4: Upload Sample Patient Data\n\nThe Darena Health App has a built in mini-EHR to help you test with the provider workflow. You can upload data using CCDA or FHIR bundles.\n\n#### Step 5: Send / Accept Patient Invite\n\nAfter you have uploaded the data, use the **Darena Health App** to send patient invites. This process allows you to simulate the provider workflow of sending patient invites. You can create a patient account by following the steps for accepting the invite. Once a patient account is created, the account can be used for any Darena Health API even if they are from different EHRs.\n\n#### Step 6: Obtain an `access_token`\n\nTest your app to connect with the Sandbox Workspace using the patient account. Darena Health APIs support the SMART on FHIR workflows to allow you to connect to the workspaces.\n\n#### Step 7: Call the Darena Health API\n\nUse the `access_token` to make a call to any Darena Health API that you are authorized to call.\n\n#### Step 8: Swap in a Live Darena Health FHIR API\n\nWhen you're ready, simply switch the FHIR API URL in your app to point it to your customer's live FHIR API URLs. No additional approval is required, and the same app that was tested in the sandbox workspace will seamlessly transition to production. You may need to work with the provider to create a test patient in their account and send an invite to test.\n\nYou can explore all healthcare providers using Darena Health in the **directory** at [https://app.meldrx.com/directory](https://app.meldrx.com/directory). The directory provides details of the healthcare providers FHIR APIs as well as all the registered providers. If you can't find the details of the provider, please ask them to share their details\n\nIf you have any questions, feel free to submit a ticket at support.darena.health or connect us on our discord channel.","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","isPublicCollection":false,"owner":"22975321","team":383284,"collectionId":"4f1469f0-f1da-402b-86b7-094cbe0ec966","publishedId":"2s9YsDkama","public":true,"publicUrl":"https://docs.darena.health","privateUrl":"https://go.postman.co/documentation/22975321-4f1469f0-f1da-402b-86b7-094cbe0ec966","customColor":{"top-bar":"095E86","right-sidebar":"303030","highlight":"095E86"},"documentationLayout":"classic-double-column","customisation":{"metaTags":[{"name":"description","value":"These are docs for how to interact with the Darena Health API."},{"name":"title","value":"Darena Health Docs"}],"appearance":{"default":"light","themes":[{"name":"dark","logo":"https://content.pstmn.io/f8a04d83-6950-460b-80d4-bd23cf54156a/UHJvcGVydHkgMT1GdWxsIENvbG9yIC0gV2hpdGUucG5n","colors":{"top-bar":"095E86","right-sidebar":"303030","highlight":"095E86"}},{"name":"light","logo":"https://content.pstmn.io/891e1f20-ec72-4ca8-8922-2798e570ed1f/UHJvcGVydHkgMT1GdWxsIENvbG9yIC0gV2hpdGUucG5n","colors":{"top-bar":"095E86","right-sidebar":"303030","highlight":"095E86"}}]}},"version":"8.10.1","publishDate":"2025-06-02T00:17:37.000Z","activeVersionTag":"latest","documentationTheme":"light","metaTags":{"title":"Darena Health Docs","description":"These are docs for how to interact with the Darena Health API."},"logos":{"logoLight":"https://content.pstmn.io/891e1f20-ec72-4ca8-8922-2798e570ed1f/UHJvcGVydHkgMT1GdWxsIENvbG9yIC0gV2hpdGUucG5n","logoDark":"https://content.pstmn.io/f8a04d83-6950-460b-80d4-bd23cf54156a/UHJvcGVydHkgMT1GdWxsIENvbG9yIC0gV2hpdGUucG5n"}},"statusCode":200},"environments":[{"name":"DarenaHealthEnvironment","id":"e9f3090c-e627-49b1-abca-4486b283d049","owner":"22975321","values":[{"key":"meldrx_launch_url","value":"","enabled":true,"type":"any"},{"key":"meldrx_base_url","value":"https://app.meldrx.com","enabled":true,"type":"default"},{"key":"mips_api_base_url","value":"https://app.meldrx.com/mms-api","enabled":true,"type":"default"},{"key":"user_app_client_id","value":"","enabled":true,"type":"default"},{"key":"user_app_client_secret","value":"","enabled":true,"type":"default"},{"key":"system_app_client_id","value":"CLIENT ID","enabled":true,"type":"default"},{"key":"system_app_client_secret","value":"CLIENT SECRET","enabled":true,"type":"secret"},{"key":"user_email","value":"","enabled":true,"type":"default"},{"key":"scope","value":"meldrx-api patient/*.* cds","enabled":true,"type":"default"},{"key":"workspace_identifier","value":"WORKSPACE_IDENTIFIER","enabled":true,"type":"default"},{"key":"workspace_slug","value":"WORKSPACE_SLUG","enabled":true,"type":"default"},{"key":"workspace_id","value":"WORKSPACE_ID","enabled":true,"type":"default"},{"key":"cc_token","value":"AutoPopulatedIfNotManuallySet","enabled":true,"type":"any"},{"key":"access_token","value":"","enabled":true,"type":"default"},{"key":"meldrx_confidential_app_id","value":"CONFIDENTIAL APP ID","enabled":true,"type":"default"},{"key":"meldrx_confidential_app_secret","value":"CONFIDENTIAL APP SECRET","enabled":true,"type":"default"},{"key":"provider_app_client_id","value":"meldrx-app","enabled":true,"type":"default"},{"key":"provider_app_scope","value":"meldrx-api openid profile patient/*.*","enabled":true,"type":"default"},{"key":"authority_api_url","value":"https://account.sb.meldrx.com/api","enabled":true,"type":"default"},{"key":"patient_app_client_id","value":"patient-test-app","enabled":true,"type":"default"},{"key":"patient_app_scope","value":"meldrx-api openid profile patient/*.read","enabled":true,"type":"default"},{"key":"parser_type","value":"CUSTOM PARSER FOR YOUR ACCOUNT","enabled":true,"type":"default"},{"key":"fhir_server_id","value":"AutoPopulatedIfNotManuallySet","enabled":true,"type":"default"},{"key":"background_process_id","value":"AutoPopulatedIfNotManuallySet","enabled":true,"type":"any"},{"key":"fhir_server_url","value":"AutoPopulatedIfNotManuallySet","enabled":true,"type":"any"},{"key":"patient_id","value":"PATIENT_ID","enabled":true,"type":"any"},{"key":"organization_id","value":"AutoPopulatedIfNotManuallySet","enabled":true,"type":"any"},{"key":"fhir_server_description","value":"AutoPopulatedIfNotManuallySet","enabled":true,"type":"default"},{"key":"accessible_patient_identifier_search_str","value":"AutoPopulatedIfNotManuallySet","enabled":true,"type":"any"},{"key":"invite_id","value":"AutoPopulatedIfNotManuallySet","enabled":true,"type":"any"},{"key":"invite_code","value":"AutoPopulatedIfNotManuallySet","enabled":true,"type":"any"},{"key":"document_reference_id","value":"AutoPopulatedIfNotManuallySet","enabled":true,"type":"any"},{"key":"user_display_name","value":"USER DISPLAY TO TEST","enabled":true,"type":"default"},{"key":"bundle_next_page","value":"","enabled":true,"type":"any"},{"key":"uploaded_doc_id","value":"","enabled":true,"type":"any"},{"key":"patient_identifier","value":"","enabled":true,"type":"any"},{"key":"group_id","value":"","enabled":true,"type":"any"},{"key":"code_challenge","value":"4QvCJCTub5oG62cIhjRbMocAi9tpo5Qy5hx5by36J5Q=","enabled":true,"type":"default"},{"key":"code_verifier","value":"IAmTheCodeChallenge","enabled":true,"type":"default"},{"key":"demo_practice1_tin","value":"","enabled":true,"type":"any"},{"key":"mips_report1_id","value":"","enabled":true,"type":"any"},{"key":"npi","value":"","enabled":true,"type":"any"},{"key":"auth_url","value":"","enabled":true,"type":"any"},{"key":"demo_practice2_tin","value":"","enabled":true,"type":"any"},{"key":"mips_report2_id","value":"","enabled":true,"type":"any"},{"key":"virtual_workspace_id","value":"","enabled":true,"type":"any"},{"key":"demo_practice3_tin","value":"","enabled":true,"type":"any"},{"key":"mips_report3_id","value":"","enabled":true,"type":"any"},{"key":"github_token","value":"","enabled":true,"type":"default"},{"key":"model_url","value":"","enabled":true,"type":"default"},{"key":"api_key","value":"","enabled":true,"type":"default"},{"key":"model_name","value":"Llama-3.2-11B-Vision-Instruct","enabled":true,"type":"default"},{"key":"patient_last_name","value":"Newman","enabled":true,"type":"default"},{"key":"ccda_date","value":"2013-10-10","enabled":true,"type":"default"},{"key":"ccda_url","value":"","enabled":true,"type":"any"},{"key":"patient_connect_code","value":"123456","enabled":true,"type":"default"},{"key":"patient_connect_organization_id","value":"AutoPopulatedIfNotManuallySet","enabled":true,"type":"default"},{"key":"mips_provider_id","value":"","enabled":true,"type":"default"}],"published":true}],"user":{"authenticated":false,"permissions":{"publish":false}},"run":{"button":{"js":"https://run.pstmn.io/button.js","css":"https://run.pstmn.io/button.css"}},"web":"https://www.getpostman.com/","team":{"logo":"https://res.cloudinary.com/postman/image/upload/t_team_logo_pubdoc/v1/team/0593d39596f19e5e015ca776b1435408a5c6cc63fe93ec94d434b7bf4688a599","favicon":"https://res.cloudinary.com/postman/image/upload/v1748647540/team/024170b4f4ebf10588e3e62414a661bb.ico"},"isEnvFetchError":false,"languages":"[{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"HttpClient\"},{\"key\":\"csharp\",\"label\":\"C#\",\"variant\":\"RestSharp\"},{\"key\":\"curl\",\"label\":\"cURL\",\"variant\":\"cURL\"},{\"key\":\"dart\",\"label\":\"Dart\",\"variant\":\"http\"},{\"key\":\"go\",\"label\":\"Go\",\"variant\":\"Native\"},{\"key\":\"http\",\"label\":\"HTTP\",\"variant\":\"HTTP\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"OkHttp\"},{\"key\":\"java\",\"label\":\"Java\",\"variant\":\"Unirest\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"Fetch\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"jQuery\"},{\"key\":\"javascript\",\"label\":\"JavaScript\",\"variant\":\"XHR\"},{\"key\":\"c\",\"label\":\"C\",\"variant\":\"libcurl\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Axios\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Native\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Request\"},{\"key\":\"nodejs\",\"label\":\"NodeJs\",\"variant\":\"Unirest\"},{\"key\":\"objective-c\",\"label\":\"Objective-C\",\"variant\":\"NSURLSession\"},{\"key\":\"ocaml\",\"label\":\"OCaml\",\"variant\":\"Cohttp\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"cURL\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"Guzzle\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"HTTP_Request2\"},{\"key\":\"php\",\"label\":\"PHP\",\"variant\":\"pecl_http\"},{\"key\":\"powershell\",\"label\":\"PowerShell\",\"variant\":\"RestMethod\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"http.client\"},{\"key\":\"python\",\"label\":\"Python\",\"variant\":\"Requests\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"httr\"},{\"key\":\"r\",\"label\":\"R\",\"variant\":\"RCurl\"},{\"key\":\"ruby\",\"label\":\"Ruby\",\"variant\":\"Net::HTTP\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"Httpie\"},{\"key\":\"shell\",\"label\":\"Shell\",\"variant\":\"wget\"},{\"key\":\"swift\",\"label\":\"Swift\",\"variant\":\"URLSession\"}]","languageSettings":[{"key":"csharp","label":"C#","variant":"HttpClient"},{"key":"csharp","label":"C#","variant":"RestSharp"},{"key":"curl","label":"cURL","variant":"cURL"},{"key":"dart","label":"Dart","variant":"http"},{"key":"go","label":"Go","variant":"Native"},{"key":"http","label":"HTTP","variant":"HTTP"},{"key":"java","label":"Java","variant":"OkHttp"},{"key":"java","label":"Java","variant":"Unirest"},{"key":"javascript","label":"JavaScript","variant":"Fetch"},{"key":"javascript","label":"JavaScript","variant":"jQuery"},{"key":"javascript","label":"JavaScript","variant":"XHR"},{"key":"c","label":"C","variant":"libcurl"},{"key":"nodejs","label":"NodeJs","variant":"Axios"},{"key":"nodejs","label":"NodeJs","variant":"Native"},{"key":"nodejs","label":"NodeJs","variant":"Request"},{"key":"nodejs","label":"NodeJs","variant":"Unirest"},{"key":"objective-c","label":"Objective-C","variant":"NSURLSession"},{"key":"ocaml","label":"OCaml","variant":"Cohttp"},{"key":"php","label":"PHP","variant":"cURL"},{"key":"php","label":"PHP","variant":"Guzzle"},{"key":"php","label":"PHP","variant":"HTTP_Request2"},{"key":"php","label":"PHP","variant":"pecl_http"},{"key":"powershell","label":"PowerShell","variant":"RestMethod"},{"key":"python","label":"Python","variant":"http.client"},{"key":"python","label":"Python","variant":"Requests"},{"key":"r","label":"R","variant":"httr"},{"key":"r","label":"R","variant":"RCurl"},{"key":"ruby","label":"Ruby","variant":"Net::HTTP"},{"key":"shell","label":"Shell","variant":"Httpie"},{"key":"shell","label":"Shell","variant":"wget"},{"key":"swift","label":"Swift","variant":"URLSession"}],"languageOptions":[{"label":"C# - HttpClient","value":"csharp - HttpClient - C#"},{"label":"C# - RestSharp","value":"csharp - RestSharp - C#"},{"label":"cURL - cURL","value":"curl - cURL - cURL"},{"label":"Dart - http","value":"dart - http - Dart"},{"label":"Go - Native","value":"go - Native - Go"},{"label":"HTTP - HTTP","value":"http - HTTP - HTTP"},{"label":"Java - OkHttp","value":"java - OkHttp - Java"},{"label":"Java - Unirest","value":"java - Unirest - Java"},{"label":"JavaScript - Fetch","value":"javascript - Fetch - JavaScript"},{"label":"JavaScript - jQuery","value":"javascript - jQuery - JavaScript"},{"label":"JavaScript - XHR","value":"javascript - XHR - JavaScript"},{"label":"C - libcurl","value":"c - libcurl - C"},{"label":"NodeJs - Axios","value":"nodejs - Axios - NodeJs"},{"label":"NodeJs - Native","value":"nodejs - Native - NodeJs"},{"label":"NodeJs - Request","value":"nodejs - Request - NodeJs"},{"label":"NodeJs - Unirest","value":"nodejs - Unirest - NodeJs"},{"label":"Objective-C - NSURLSession","value":"objective-c - NSURLSession - Objective-C"},{"label":"OCaml - Cohttp","value":"ocaml - Cohttp - OCaml"},{"label":"PHP - cURL","value":"php - cURL - PHP"},{"label":"PHP - Guzzle","value":"php - Guzzle - PHP"},{"label":"PHP - HTTP_Request2","value":"php - HTTP_Request2 - PHP"},{"label":"PHP - pecl_http","value":"php - pecl_http - PHP"},{"label":"PowerShell - RestMethod","value":"powershell - RestMethod - PowerShell"},{"label":"Python - http.client","value":"python - http.client - Python"},{"label":"Python - Requests","value":"python - Requests - Python"},{"label":"R - httr","value":"r - httr - R"},{"label":"R - RCurl","value":"r - RCurl - R"},{"label":"Ruby - Net::HTTP","value":"ruby - Net::HTTP - Ruby"},{"label":"Shell - Httpie","value":"shell - Httpie - Shell"},{"label":"Shell - wget","value":"shell - wget - Shell"},{"label":"Swift - URLSession","value":"swift - URLSession - Swift"}],"layoutOptions":[{"value":"classic-single-column","label":"Single Column"},{"value":"classic-double-column","label":"Double Column"}],"versionOptions":[],"environmentOptions":[{"value":"0","label":"No Environment"},{"label":"DarenaHealthEnvironment","value":"22975321-e9f3090c-e627-49b1-abca-4486b283d049"}],"canonicalUrl":"https://docs.darena.health/view/metadata/2s9YsDkama"}