Questioning Dyna Content POST

The Dyna API POST /v1/content/search/rag endpoint allows you to question DynaMed, DynaMedex or Dynamic Health content. It uses a streaming response so that the answer can begin to be displayed as soon as the response begins. Dyna uses Retrieval Augmented Generation (RAG) to query DynaMed, DynaMedex or Dynamic Health content to create a thorough, "guard railed", and reliable response.

Basic Dyna Search

To Perform a Basic Dyna Search (example):

Gather the following information for the request:

  • A query to ask.
  • The following headers:
    • Authorization: a personalized access token
    • x-eis-id-token: an ID token is required to keep a history of the queries
    • Connection: keep-alive
    • Cache-Control: no-cache
    • X-Accel-Buffering-Type: no

A query is used as a first attempt at getting an answer. It might be used when the user has entered terms into a search box. Dyna will take the terms and formulate a question. In the examples that follow, we assume DynaMedex queries and responses. DynaMed and Dynamic Health are similar.

Request

POST 'https://apis.ebsco.com/medsapi-dynamedex/v1/content/search/rag'

Request Body

{
  "criteria": {
     "query": " what is the cause of hypercalcemia in a 35 year old woman with squamous cell lung cancer, granulomatous TB and abnormal lab values"
  }
}

The Dyna search will respond with multiple lines before closing the connection. Each response will minimally look like the following:

data: {
  "viewModel":{...}
}\n\n

Prepending "data:" to each response is a technique used in Server-Sent Events (SSE). SSE is a standard that allows servers to push updates to clients over HTTP or HTTPS. The updates are sent as a stream of text data, where each message is separated by a pair of newline characters. This helps in message identification, allows for real time updates, and network error handling. It looks like a string followed by JSON. This format is to make it easier to read in this documentation. In actuality, the response is a string. It will need to be parsed to convert it into JSON format.

Example First Response

Below is an example of a first response to the request above.

data: {
    "viewModel": {
        "conceptCount": 13,
        "supported": true,
        "query": "what is the cause of hypercalcemia in a 35 year old woman with squamous cell lung cancer, granulomatous TB and abnormal lab values",
        "question": "What is the cause of hypercalcemia in a 35-year-old woman with squamous cell lung cancer, granulomatous TB, and abnormal lab values?",
        "answer": "",
        "answerFound": false,
        "disclaimer": {
            "content": "Dyna AI responses are for educational purposes only and should not be solely relied upon for medical practice.",
            "moreContent": "The presentation of a response does not imply any specific ranking by importance or probability and a response may not include all possibly relevant material. Interpretation and application are subject to the judgment of a healthcare professional. Dyna AI responses are not intended to serve as recommendations for individual patients. Do not enter Protected Health Information (PHI)."
        },
        "references": {
            "title": "DynaMedex Sources",
            "hasNotes": false,
            "results": []
        },
        "recommendedQuestions": [],
        "recommendedContent": {
            "title": "Recommended Content",
            "hasNotes": false,
            "results": []
        },
        "followupQuestions": {
            "title": "Ask a Follow-up",
            "enabled": true
        },
        "streamComplete": false,
        "telemetryData": {
            "searchTerm": "what is the cause of hypercalcemia in a 35 year old woman with squamous cell lung cancer, granulomatous TB and abnormal lab values",
            "question": "What is the cause of hypercalcemia in a 35-year-old woman with squamous cell lung cancer, granulomatous TB, and abnormal lab values?",
            "answerFound": false,
            "answerNotFound": true,
            "conceptCount": 13
        }
    }
}

In this first response, note that the answer is empty, answerFound is false and the streamComplete flag is set to false. Your code should inspect each response and expect more responses until the streamComplete flag is true. Several of these may occur while Dyna begins to process the question, with minor differences. For example, the next message might contain all the fields above plus the question that Dyna will use to get the answer. Note that the answer may contain any valid HTML. However, these tags are more likely to occur:

<ul>,<li>,<ol>,<strong>,<b>,<em>,<sub>,<sup>,<a>, and <br>.

<table> may occur in the future.

Example Secondary Responses

data:{
  "viewModel":{
     "answerStream":"I"
   }
}
Secondary responses are generally short messages which enable the calling application to begin displaying the response as it is returned. When output to the user, the responses will contain the complete answer that Dyna has found. The answer stream may contain a complete HTML element, such as <ul>. It is not always a single character.

Example Answer Found Response

data:{
    "viewModel": {
        "conceptCount": 13,
        "supported": true,
        "query": "what is the cause of hypercalcemia in a 35 year old woman with squamous cell lung cancer, granulomatous TB and abnormal lab values",
        "question": "What is the cause of hypercalcemia in a 35-year-old woman with squamous cell lung cancer, granulomatous TB, and abnormal lab values?",
        "answer": " <ul><li>Hypercalcemia in a 35-year-old woman with squamous cell lung cancer may be caused by humoral hypercalcemia of malignancy, which is a paraneoplastic syndrome due to ectopic production of parathyroid hormone-related peptide (PTHrP) by the tumor. This condition is most commonly associated with squamous cell lung cancer.<sup data-type='references'><span data-ref-id='dcmooctcjh'>1</span>,<span data-ref-id='5ik9krujo5'>2</span></sup></li><li>Granulomatous tuberculosis (TB) can also cause hypercalcemia due to elevated calcitriol levels resulting from excessive production or decreased degradation of calcitriol. This leads to increased intestinal absorption of calcium and phosphate, enhanced bone resorption, and hypercalcemia.<sup data-type='references'><span data-ref-id='ir26q00et3'>3</span></sup></li></ul>",
        "answerFound": true,
        "conversationId": "2026-01-16-9b9645c1-e914-4495-8467-d98f6f46c570",
        "messageId": "0",
        "disclaimer": {
            "content": "Dyna AI responses are for educational purposes only and should not be solely relied upon for medical practice.",
            "moreContent": "The presentation of a response does not imply any specific ranking by importance or probability and a response may not include all possibly relevant material. Interpretation and application are subject to the judgment of a healthcare professional. Dyna AI responses are not intended to serve as recommendations for individual patients. Do not enter Protected Health Information (PHI)."
        },
        "references": {
            "title": "DynaMedex Sources",
            "hasNotes": false,
            "results": [
                {
                    "slug": "/condition/hypercalcemia-1",
                    "title": "Hypercalcemia >",
                    "sections": [
                        {
                            "title": "Malignancy",
                            "slug": "/condition/hypercalcemia-1",
                            "anchor": "MALIGNANCY",
                            "breadcrumb": "Background Information > Etiology and Pathogenesis > Causes > Conditions Associated With Increased Bone Resorption >",
                            "refIndex": 1,
                            "metadata": {
                                "title": "Hypercalcemia",
                                "navigateTo": [
                                    "Background Information",
                                    "Etiology and Pathogenesis",
                                    "Causes",
                                    "Conditions Associated With Increased Bone Resorption",
                                    "Malignancy"
                                ],
                                "id": "T116018",
                                "pubType": {
                                    "pretty": "Condition",
                                    "id": "condition",
                                    "group": "articles"
                                }
                            }
                        },
                        {
                            "title": "Vitamin D Toxicity (Exogenous and Endogenous)",
                            "slug": "/condition/hypercalcemia-1",
                            "anchor": "VITAMIN_D_EXCESS",
                            "breadcrumb": "Background Information > Etiology and Pathogenesis > Causes >",
                            "refIndex": 3,
                            "metadata": {
                                "title": "Hypercalcemia",
                                "navigateTo": [
                                    "Background Information",
                                    "Etiology and Pathogenesis",
                                    "Causes",
                                    "Vitamin D Toxicity (Exogenous and Endogenous)"
                                ],
                                "id": "T116018",
                                "pubType": {
                                    "pretty": "Condition",
                                    "id": "condition",
                                    "group": "articles"
                                }
                            }
                        }
                    ],
                    "hasNote": false,
                    "metadata": {
                        "title": "Hypercalcemia",
                        "id": "T116018"
                    }
                },
                {
                    "slug": "/condition/non-small-cell-lung-cancer",
                    "title": "Non-small Cell Lung Cancer >",
                    "sections": [
                        {
                            "title": "Complications",
                            "slug": "/condition/non-small-cell-lung-cancer",
                            "anchor": "GUID-B8A8CB66-6550-4AD3-A05A-EDF0E9C6B991",
                            "breadcrumb": null,
                            "refIndex": 2,
                            "metadata": {
                                "title": "Non-small Cell Lung Cancer",
                                "navigateTo": [
                                    "Complications"
                                ],
                                "id": "T114774",
                                "pubType": {
                                    "pretty": "Condition",
                                    "id": "condition",
                                    "group": "articles"
                                }
                            }
                        }
                    ],
                    "hasNote": false,
                    "metadata": {
                        "title": "Non-small Cell Lung Cancer",
                        "id": "T114774"
                    }
                }
            ]
        },
        "recommendedQuestions": [],
        "recommendedContent": {
            "title": "Recommended Content",
            "hasNotes": false,
            "results": []
        },
        "followupQuestions": {
            "title": "Ask a Follow-up",
            "enabled": true
        },
        "streamComplete": false,
        "telemetryData": {
            "searchTerm": "what is the cause of hypercalcemia in a 35 year old woman with squamous cell lung cancer, granulomatous TB and abnormal lab values",
            "question": "What is the cause of hypercalcemia in a 35-year-old woman with squamous cell lung cancer, granulomatous TB, and abnormal lab values?",
            "pageToken": "2026-01-16-9b9645c1-e914-4495-8467-d98f6f46c570",
            "conversationId": "2026-01-16-9b9645c1-e914-4495-8467-d98f6f46c570",
            "messageId": "0",
            "searchTimeInMs": 116,
            "ragResponseTimeInMs": 9242,
            "userIntentTimeInMs": 920,
            "answerFound": true,
            "answerNotFound": false,
            "userIntentCategory": "DM_ETIOLOGY",
            "conceptCount": 13,
            "disclaimer": false
        }
    }
}

The answer is available and is now displayed in its entirety.

Note: streamComplete is not set to true yet.

Final Response

data:{
    "viewModel": {
        "conceptCount": 13,
        "supported": true,
        "query": "what is the cause of hypercalcemia in a 35 year old woman with squamous cell lung cancer, granulomatous TB and abnormal lab values",
        "question": "What is the cause of hypercalcemia in a 35-year-old woman with squamous cell lung cancer, granulomatous TB, and abnormal lab values?",
        "answer": " <ul><li>Hypercalcemia in a 35-year-old woman with squamous cell lung cancer may be caused by humoral hypercalcemia of malignancy, which is a paraneoplastic syndrome due to ectopic production of parathyroid hormone-related peptide (PTHrP) by the tumor. This condition is most commonly associated with squamous cell lung cancer.<sup data-type='references'><span data-ref-id='dcmooctcjh'>1</span>,<span data-ref-id='5ik9krujo5'>2</span></sup></li><li>Granulomatous tuberculosis (TB) can also cause hypercalcemia due to elevated calcitriol levels resulting from excessive production or decreased degradation of calcitriol. This leads to increased intestinal absorption of calcium and phosphate, enhanced bone resorption, and hypercalcemia.<sup data-type='references'><span data-ref-id='ir26q00et3'>3</span></sup></li></ul>",
        "answerFound": true,
        "conversationId": "2026-01-16-9b9645c1-e914-4495-8467-d98f6f46c570",
        "messageId": "0",
        "disclaimer": {
            "content": "Dyna AI responses are for educational purposes only and should not be solely relied upon for medical practice.",
            "moreContent": "The presentation of a response does not imply any specific ranking by importance or probability and a response may not include all possibly relevant material. Interpretation and application are subject to the judgment of a healthcare professional. Dyna AI responses are not intended to serve as recommendations for individual patients. Do not enter Protected Health Information (PHI)."
        },
        "references": {
            "title": "DynaMed Sources",
            "hasNotes": false,
            "results": [
                {
                    "slug": "/condition/hypercalcemia-1",
                    "title": "Hypercalcemia >",
                    "sections": [
                        {
                            "title": "Malignancy",
                            "slug": "/condition/hypercalcemia-1",
                            "anchor": "MALIGNANCY",
                            "breadcrumb": "Background Information > Etiology and Pathogenesis > Causes > Conditions Associated With Increased Bone Resorption >",
                            "refIndex": 1,
                            "metadata": {
                                "title": "Hypercalcemia",
                                "navigateTo": [
                                    "Background Information",
                                    "Etiology and Pathogenesis",
                                    "Causes",
                                    "Conditions Associated With Increased Bone Resorption",
                                    "Malignancy"
                                ],
                                "id": "T116018",
                                "pubType": {
                                    "pretty": "Condition",
                                    "id": "condition",
                                    "group": "articles"
                                }
                            }
                        },
                        {
                            "title": "Vitamin D Toxicity (Exogenous and Endogenous)",
                            "slug": "/condition/hypercalcemia-1",
                            "anchor": "VITAMIN_D_EXCESS",
                            "breadcrumb": "Background Information > Etiology and Pathogenesis > Causes >",
                            "refIndex": 3,
                            "metadata": {
                                "title": "Hypercalcemia",
                                "navigateTo": [
                                    "Background Information",
                                    "Etiology and Pathogenesis",
                                    "Causes",
                                    "Vitamin D Toxicity (Exogenous and Endogenous)"
                                ],
                                "id": "T116018",
                                "pubType": {
                                    "pretty": "Condition",
                                    "id": "condition",
                                    "group": "articles"
                                }
                            }
                        }
                    ],
                    "hasNote": false,
                    "metadata": {
                        "title": "Hypercalcemia",
                        "id": "T116018"
                    }
                },
                {
                    "slug": "/condition/non-small-cell-lung-cancer",
                    "title": "Non-small Cell Lung Cancer >",
                    "sections": [
                        {
                            "title": "Complications",
                            "slug": "/condition/non-small-cell-lung-cancer",
                            "anchor": "GUID-B8A8CB66-6550-4AD3-A05A-EDF0E9C6B991",
                            "breadcrumb": null,
                            "refIndex": 2,
                            "metadata": {
                                "title": "Non-small Cell Lung Cancer",
                                "navigateTo": [
                                    "Complications"
                                ],
                                "id": "T114774",
                                "pubType": {
                                    "pretty": "Condition",
                                    "id": "condition",
                                    "group": "articles"
                                }
                            }
                        }
                    ],
                    "hasNote": false,
                    "metadata": {
                        "title": "Non-small Cell Lung Cancer",
                        "id": "T114774"
                    }
                }
            ]
        },
        "media": {
            "images": {
                "title": "Images:",
                "results": [
                    {
                        "id": "I1699300761963",
                        "publicId": "EBSCOHealth/CCMS/Dynamed/images/I1699300761963",
                        "title": "Metastatic pulmonary calcification",
                        "description": "(A) Chest radiograph reveals poorly defined bilateral nodular opacities in the superior lung fields. (B) Axial computed tomography image of the chest shows centrilobular ground-glass nodules and heterogeneous attenuation, features suggestive of calcium deposition. ",
                        "copyright": "© 2010 Massachusetts Medical Society. All rights reserved. Used with permission.",
                        "format": "jpg",
                        "alt": "(A) Chest radiograph reveals poorly defined bilateral nodular opacities in the superior lung fields. (B) Axial computed tomography image of the chest shows centrilobular ground-glass nodules and heterogeneous attenuation, features suggestive of calcium deposition. ",
                        "links": [
                          {
                            "rel": "external",
                            "href": "https://media.ebsco.healthcare/eis-live/image/authenticated/t_s200/v1/EBSCOHealth/CCMS/Dynamed/images/I502093.jpg?__cld_token__=exp=1769097593~hmac=d1eb3eaebdbcb6263dbfe7bd146771e87bc3028dcb3d37288c1b61f566b98dc8",
                            "imageSize": "small"
                          }
                        ],
                        "telemetryData": {
                            "id": "I1699300761963",
                            "title": "Metastatic pulmonary calcification",
                            "format": "jpg"
                        }
                    },
                    {
                        "id": "I1703803563037",
                        "publicId": "EBSCOHealth/CCMS/Dynamed/images/I1703803563037",
                        "title": "Latent tuberculosis, chest radiograph",
                        "description": "Posteroanterior chest radiograph shows scattered calcified nodules (arrows) in setting of a positive tuberculin skin test. ",
                        "copyright": "Modified with permission. Nachiappan AC, Rahbar K, Shi X, Guy ES, Mortani Barbosa EJ Jr, Shroff GS, Ocazionez D, Schlesinger AE, Katz SI, Hammer MM. Pulmonary Tuberculosis: Role of Radiology in Diagnosis and Management. Radiographics. 2017 Jan-Feb;37(1):52-72. ©2023 Radiological Society of North America.",
                        "format": "jpg",
                        "alt": "Posteroanterior chest radiograph shows scattered calcified nodules (arrows) in setting of a positive tuberculin skin test. ",
                        "links": [
                          {
                            "rel": "external",
                            "href": "https://media.ebsco.healthcare/eis-live/image/authenticated/t_s200/v1/EBSCOHealth/CCMS/Dynamed/images/I1616935757565.jpg?__cld_token__=exp=1769097593~hmac=b41cb9b509d99d4d4ee68605a7f781cb77733f8e825789d9ea53894485515013",
                            "imageSize": "small"
                          }
                        ],
                        "telemetryData": {
                            "id": "I1703803563037",
                            "title": "Latent tuberculosis, chest radiograph",
                            "format": "jpg"
                        }
                    }
                ]
            },
            "algorithms": {
                "title": "Algorithms:",
                "results": [
                    {
                        "id": "A1655215417932",
                        "publicId": "EBSCOHealth/CCMS/Dynamed/images/A1655215417932",
                        "title": "Hypercalcemia diagnosis algorithm",
                        "description": "Adapted from Pediatr Nephrol. 2018 Sep;33(9):1475-1488, Clin Med. (Lond) 2017 Jun;17(3):270-273, BMJ. 2015 Jun 2;350:h2723. Last reviewed 2025. ",
                        "pubType": "algorithm",
                        "copyright": "Copyright ©2025 EBSCO Information Services.",
                        "format": "svg",
                        "alt": "Adapted from Pediatr Nephrol. 2018 Sep;33(9):1475-1488, Clin Med. (Lond) 2017 Jun;17(3):270-273, BMJ. 2015 Jun 2;350:h2723. Last reviewed 2025. ",
                        "links": [
                          {
                            "rel": "external",
                            "href": "https://media.ebsco.healthcare/eis-live/image/authenticated/v1/EBSCOHealth/CCMS/Dynamed/images/A1686155706208.svg?__cld_token__=exp=1769097593~hmac=457aa9eab89a21ea500f46e5860230d506c5305bd802e4245211a37b4855c915",
                            "imageSize": "small"
                          }
                        ],
                        "telemetryData": {
                            "id": "A1655215417932",
                            "title": "Hypercalcemia diagnosis algorithm",
                            "format": "svg"
                        }
                    }
                ]
            }
        },
        "recommendedQuestions": [
            "What are the common causes of hypercalcemia in adults?",
            "What are the diagnostic criteria for hypercalcemia?",
            "What are the risk factors associated with hypercalcemia?"
        ],
        "recommendedContent": {
            "title": "Recommended Content",
            "hasNotes": false,
            "results": []
        },
        "followupQuestions": {
            "title": "Ask a Follow-up",
            "enabled": true
        },
        "streamComplete": true,
        "telemetryData": {
            "searchTerm": "what is the cause of hypercalcemia in a 35 year old woman with squamous cell lung cancer, granulomatous TB and abnormal lab values",
            "question": "What is the cause of hypercalcemia in a 35-year-old woman with squamous cell lung cancer, granulomatous TB, and abnormal lab values?",
            "pageToken": "2026-01-16-9b9645c1-e914-4495-8467-d98f6f46c570",
            "conversationId": "2026-01-16-9b9645c1-e914-4495-8467-d98f6f46c570",
            "messageId": "0",
            "searchTimeInMs": 116,
            "ragResponseTimeInMs": 9242,
            "userIntentTimeInMs": 920,
            "answerFound": true,
            "answerNotFound": false,
            "userIntentCategory": "DM_ETIOLOGY",
            "conceptCount": 13,
            "disclaimer": false,
            "imageCount": 2,
            "algorithmCount": 1,
            "createdAt": "2026-01-16T18:04:39.995Z"
        }
    }
}

Above you will notice that streamComplete and answerFound are true, and now in addition to the answer, references are included.

📘

Please note that media responses are subject to change.

Response Details

NameTypeDescriptionExample
viewModelobject  
viewModel.querystringThe primary concept for the question. This helps to focus the question.what is the cause of hypercalcemia in a 35 year old woman with squamous cell lung cancer, granulomatous TB and abnormal lab values
viewModel.questionstringThe question to be answered. Note that the original query may be refined to clarify the question that Dyna is answeringWhat is the cause of hypercalcemia in a 35-year-old woman with squamous cell lung cancer, granulomatous TB, and abnormal lab values?
viewModel.answerstringThe answer to the question.
  • In adults, about 90% of hypercalcemia cases are caused by primary hyperparathyroidism or malignancy.1,2
  • Hypercalcemia of malignancy can result from…”
viewModel.answerFoundBooleanIndicates if the complete answer has been foundtrue
viewModel.supportedBooleanIndicates whether Dyna is qualified to answer the questiontrue
viewModel.conceptCountintegerThe number of medical concepts covered by the query1
viewModel.conversationIdstringIdentifier to be used for subsequent requests2025-11-20-9eafda52-9013-4523-9f7e-580e727757d1
viewModel.messageIdstringReflects the number of queries for this Dyna conversation1
viewModel.disclaimerobject  
viewModel.disclaimer.contentstringDisclaimer contentDyna AI responses are for educational purposes only and should not be solely relied upon for medical practice.
viewModel.disclaimer.moreContentstringAdditional disclaimersThe presentation of a response does not imply any specific ranking by importance or probability and a response may not include all possibly relevant material. Interpretation and application are subject to the judgment of a healthcare professional. Dyna AI responses are not intended to serve as recommendations for individual patients. Do not enter Protected Health Information (PHI).
viewModel.workplaceNotesobject  
viewModel.workplaceNotes.messagestringA message to call attention that the answer includes a workplace note when returning Dynamic Health contentA note from your workplace is included that should be reviewed. (Notes are not included in the Dyna AI response)
viewModel.workplaceSkillsobject  
viewModel.workplaceSkills.messagestringA message to call attention that the answer includes a workplace skill when returning Dynamic Health contentOne or more related 'Your Workplace Skills' exist and are not included in this Dyna AI response
viewModel.workplaceSkills.resultsarray  
viewModel.workplaceSkills.results.urlstringURL of the skillhttps://apis.ebsco.com/medsapi-dynamic-health/v1/content/custom-articles/C1767984405021
viewModel.workplaceSkills.results.titlestringTitle of the skillCase Management for Patients with Diabetes Workplace Skill
viewModel.workplaceSkills.results.idstringID of the skill which can be sued with the custom article endpointC1767984405021
viewModel.referencesobjectReferences used to provide the answer 
viewModel.references.titlestringTitle to showDynaMedex Sources Used
viewModel.hasNotesBooleanIndicates if there are workplace notes in any results. Only possible if Dynamic Healthfalse
viewModel.references.resultsarray of objectList of references 
viewModel.references.results.slugstringSlug to the page cited. Use the slug endpoint to get the article./condition/hypercalcemia-1
viewModel.references.results.titlestringTitle of the page citedHypercalcemia >
viewModel.references.results.sectionsarray of object  
viewModel.references.results.sections.titlestringTitle of the specific section on the page cited in the answerMost Common Causes by Age
viewModel.references.results.sections.anchorstringSection anchorTOPIC_KCS_QBJ_SQB
viewModel.references.results.sections.slugstringSlug to the page and section. The slug endpoint can be used to display the section./condition/hypercalcemia-1
viewModel.references.results.sections.breadcrumbstringBreadcrumb to be displayedBackground Information > Etiology and Pathogenesis > Causes >
viewModel.references.results.sections.refIndexintegerMatches to the “1” in the answer1
viewModel.references.results.sections.metadataobjectContextualizing information for the UI 
viewModel.references.results.sections.metadata.titlearray of stringTitle of this referenceHypercalcemia
viewModel.references.results.sections.metadata.navigateToarray of stringNavigational guidanceBackground Information
viewModel.references.results.sections.metadata.idstringArticle IDT116018
viewModel.references.results.sections.metadata.pubTypeobjectPublication information 
viewModel.references.results.sections.metadata.pubType.prettystringDisplay publication nameCondition
viewModel.references.results.sections.metadata.pubType.idstringID for the publicationcondition
viewModel.references.results.sections.metadata.pubType.groupstringGroup for the pubTypearticles
viewModel.references.results.hasNoteBooleanIndicates if any section has workplace notes. This is ONLY for Dynamic Health.false
viewModel.references.results.metadataobject  
viewModel.references.results.metadata.titlestringTitle of the Article used in the answerHypercalcemia
viewModel.references.results.metadata.idstringArticle ID. This can be used with the article endpoint to get the article.T116018
viewModel.recommendedQuestionsarray of stringQuestions that might be used for follow-up on this answer.What are the main environmental and genetic risk factors for developing…
viewModel.recommendedContentobjectRecommended content related to the answer 
viewModel.recommendedContent.titlestringTitle for the UIRecommended Content
viewModel.recommendedContent.resultsarray of object  
viewModel.recommendedContent.hasNotesBooleanIndicates if content contains a workplace note when the request is for Dynamic Health. 
viewModel.mediaobject  
viewModel.media.imagesobject  
viewModel.media.images.resultsarray of object  
viewModel.media.images.results.idstringImage identifierI1703803563037
viewModel.media.images.results.titlestringTitle of the imageLatent tuberculosis, chest radiograph
viewModel.media.images.results.descriptionstringDescription of the imagePosteroanterior chest radiograph shows scattered calcified nodules (arrows) in setting of a positive tuberculin skin test.
viewModel.media.images.results.pubtypestringPublication typeimage
viewModel.media.images.results.linksstringArray of image links. 
viewModel.media.images.results.links.relstringType of linkexternal
viewModel.media.images.results.links.hrefstringArray of image links.https://api.cloudinary.com/v1_1/eis-live/image/download?expires_at=1767771315&signature=2cc0dee4e97632246d6cec067eab15e385716cca&api_key=731973324641974&format=jpg&type=authenticated&public_id=EBSCOHealth%2FCCMS%2FDynamed%2Fimages%2FI1703803563037×tamp=1765179315
viewModel.media.images.results.links.imageSizestringIndicates the size of the image that was returnedsmall
viewModel.media.images.results.copyrightstringCopyright informationModified with permission. Nachiappan AC, Rahbar K, Shi X, Guy ES, Mortani Barbosa EJ Jr, Shroff GS, Ocazionez D, Schlesinger AE, Katz SI, Hammer MM. Pulmonary Tuberculosis: Role of Radiology in Diagnosis and Management. Radiographics. 2017 Jan-Feb;37(1):52-72. ©2023 Radiological Society of North America.
viewModel.media.images.results.metadataobject  
viewModel.media.images.results.metadata.formatstringImage delivery typejpg
viewModel.media.images.results.metadata.publicIdstringPublic IdEBSCOHealth/CCMS/Dynamed/images/I1703803563037
viewModel.media.algorithmsobject  
viewModel.media.algorithms.resultsarray of object  
viewModel.media.algorithms.results.idstringImage identifierA1655215417932
viewModel.media.algorithms.results.titlestringTitle of the imageHypercalcemia diagnosis algorithm
viewModel.media.algorithms.results.descriptionstringDescription of the imageAdapted from Pediatr Nephrol. 2018 Sep;33(9):1475-1488, Clin Med. (Lond) 2017 Jun;17(3):270-273, BMJ. 2015 Jun 2;350:h2723. Last reviewed 2025.
viewModel.media.algorithms.results.pubtypestringPublication typealgorithm
viewModel.media.algorithms.results.urlstringURL for the media imagehttps://api.cloudinary.com/v1_1/eis-live/image/download?expires_at=1767764876&signature=b08679b852116fc7f9d42942a2b110dce11f9d05&api_key=731973324641974&format=pdf&type=authenticated&public_id=EBSCOHealth%2FCCMS%2FDynamed%2Fimages%2FA1655215417932×tamp=1765172876
viewModel.media.algorithms.results.copyrightstringCopyright informationCopyright ©2025 EBSCO Information Services.
viewModel.media.algorithms.results.metadataobject  
viewModel.media.algorithms.results.metadata.formatstringAlgorithm delivery typesvg
viewModel.media.algorithms.results.metadata.publicIdstringPublic IdEBSCOHealth/CCMS/Dynamed/images/A1655215417932
viewModel.followupQuestionsobject  
viewModel.followupQuestions.titlestringTitle to displayAsk a Follow-up
viewModel.followupQuestions.enabledBooleanIndicates if follow up queries may be askedtrue
viewModel.telemetryDataobject  
viewModel.telemetryData.searchTermstringOriginal search termwhat is the cause of hypercalcemia in a 35 year old woman with squamous cell lung cancer, granulomatous TB and abnormal lab values
viewModel.telemetryData.questionstringQuestion that was askedWhat is the cause of hypercalcemia in a 35-year-old woman with squamous cell lung cancer, granulomatous TB, and abnormal lab values?
viewModel.telemetryData.conversationIdstringConversation Idaf11b3ae-9d06-4fc8-a994-bc72a9332d7c
viewModel.telemetryData.messageIdstringThe number of questions related to this query3
viewModel.telemetryData.pageTokenstringToken used for follow-up questionsffcbe22b-09fb-4473-99af-2acbbd1d860e
viewModel.telemetryData.searchTimeInMsintegerTime to search16103
viewModel.telemetryData.ragResponsesearchTimeInMsintegerRAG search time11158
viewModel.telemetryData.userIntentsearchTimeInMsintegerTime to focus the answer4792
viewModel.telemetryData.conceptCountintegerThe number of medical concepts covered by the query0
viewModel.telemetryData.answerFoundBooleanIndicates if there is an answerfalse
viewModel.telemetryData.answerNotFoundBooleanIndicates if there is an answer - this is needed for EBSCO statisticstrue
viewModel.telemetryData.disclaimerbooleanIndicates whether or not the query intent category triggered a disclaimer that was included with the answerfalse
viewModel.telemetryData.userIntentCategorystringCategory of the answerDM_ETIOLOGY
viewModel.streamCompleteBooleanFlag to indicate if the streaming response is complete

References

An answer to a Dyna query may contain references which were used to create the answer. The reference section contains the reference details. Among the details would be a refIndex which will tie back to the index in the answer. For example, in the answer:

"<ul><li>Hypercalcemia in a 35-year-old woman with squamous cell lung cancer may be caused by humoral hypercalcemia of malignancy, which is a paraneoplastic syndrome due to ectopic production of parathyroid hormone-related peptide (PTHrP) by the tumor. This condition is most commonly associated with squamous cell lung cancer.<sup data-type='references'><span data-ref-id='dcmooctcjh'>1</span>,<span data-ref-id='5ik9krujo5'>2</span></sup></li><li>Granulomatous tuberculosis (TB) can also cause hypercalcemia due to elevated calcitriol levels resulting from excessive production or decreased degradation of calcitriol. This leads to increased intestinal absorption of calcium and phosphate, enhanced bone resorption, and hypercalcemia.<sup data-type='references'><span data-ref-id='ir26q00et3'>3</span></sup></li></ul>"

Note the following span:

<span data-ref-id='dcmooctcjh'>1</span>

This span ties the reference to a refIndex of 1.

Dynamic Health Workplace Skills and Notes

When executing a Dyna query against Dynamic Health, the response could contain workplace skills and or workplace notes. Workplace notes appear at the top of an article and provide specific guidance for that subject for the organization. When there is a workplace note, used on top to inform the answer, the workplaceNotes section will appear with a message indicating that it was used in the response.

Likewise for workplace skills, which indicate an organizations specific instructions for a particular procedure. The workplace skills section will appear along with the URL of that skill, the title and the ID. The ID may be used with the custom articles API to get the content.

Follow Up Questions

A user may want to ask additional questions related to the original query. The POST body needs to reflect the original query and question so that it has the full context. The response will have a similar format to what is shown above. Up to 4 additional follow-up questions may be asked. Note that conversation history is saved so that it can later be retrieved via the conversation history endpoints and displayed to the user.

Request Parameters for Follow-up Questions

FieldTypeRequestDescription
criteriaObjecttrueParent object to hold the criteria for this request.
criteria.queryStringfalseThe query that the user has entered. The API requires either the query or the question. The question will be used if both are provided.
criteria.conversationIdStringfalseAll the follow on questions in a given session will share the same 'conversationId'. It remains constant throughout the session. For the first request, the 'conservationId' is not required on the first request. Retrieve 'conservationId' from the previous response.
criteria.messageIdStringfalseEach follow on question will have 'messageId' associated with it. For the first 'follow-on' question request, the id will be 0.
criteria.questionStringfalseThe question that was recommended. The API requires either the query or the question. The question will be used if both are provided.
criteria.historyArrayfalseParent object to hold previous questions / answers that the user provided.
criteria.history.queryStringfalseThe previous query that the user executed. Either the query or question field is required.
criteria.history.questionStringfalseThe previous question that the user executed. Either the query or question field is required.
criteria.history.responseStringfalseThe previous response that the user executed.

Example First Request

The first request and response follows the pattern above. For example, the first request might be:

{
  "criteria": {
    "query": "what is the cause of hypercalcemia in a 35 year old woman with squamous cell lung cancer, granulomatous TB and abnormal lab values"
  }
}

Example Second Request - The Follow Up Query

The second request might be a follow up to "what is the cause of hypercalcemia…". "How is it managed?" This is built using the query, question, answer, conversationId and messageId from the first response.

{
  "criteria": {
    "query": "How is it managed",
    "conversationId": "2026-01-14-baf70a9f-7d0b-4c9c-a96a-3f1d53a9db61",
    "messageId": "0",
    "history": [
        {
            "query": "what is the cause of hypercalcemia in a 35 year old woman with squamous cell lung cancer, granulomatous TB and abnormal lab values",
            "response": " <ul><li>Hypercalcemia in a 35-year-old woman with squamous cell lung cancer may be caused by ectopic production of parathyroid hormone-related protein (PTHrP) by the tumor, which is the most common cause of hypercalcemia in squamous cell lung cancer.<sup data-type='references'><span data-ref-id='fgn6imbi00'>1</span></sup></li><li>Granulomatous tuberculosis (TB) can lead to hypercalcemia due to elevated calcitriol levels resulting from excessive production or decreased degradation of calcitriol. This results in increased intestinal absorption of calcium and phosphate, enhanced bone resorption, hypercalcemia, and hyperphosphatemia.<sup data-type='references'><span data-ref-id='7cc87o01gj'>2</span></sup></li></ul>",
            "question": "What is the cause of hypercalcemia in a 35-year-old woman with squamous cell lung cancer, granulomatous TB, and abnormal lab values?"
        }
    ]
  }
}

The request now consists of a new query, a conversationId, and messageId which were returned in the previous response. The history consists of the original query made by the caller, the answer and the question that were used - all coming from the previous response.

Example Follow Up Response

data:{
    "viewModel": {
        "conceptCount": 2,
        "supported": true,
        "query": "How is it managed",
        "question": "How is hypercalcemia managed in a 35-year-old woman with squamous cell lung cancer, granulomatous TB, and abnormal lab values?",
        "answer": " <ul><li>Hypercalcemia in patients with squamous cell lung cancer is often caused by humoral hypercalcemia of malignancy due to the tumor secreting parathyroid hormone-related peptide (PTHrP). Management includes IV rehydration with normal saline (2-4 L/day for 1-3 days) to reduce calcium levels and bisphosphonates, such as pamidronate or zoledronic acid, to suppress osteoclast activity. Denosumab may be considered for patients with renal dysfunction or refractory hypercalcemia.<sup data-type='references'><span data-ref-id='o19iff7j29'>1</span>,<span data-ref-id='avt4dht8j7'>2</span>,<span data-ref-id='sv28fcl2gg'>3</span></sup></li><li>Granulomatous tuberculosis (TB) can cause hypercalcemia due to elevated calcitriol levels, leading to increased intestinal calcium absorption. Management includes glucocorticoid therapy to reduce calcitriol production. If hypercalcemia persists, IV bisphosphonates or denosumab may be added.<sup data-type='references'><span data-ref-id='avt4dht8j7'>2</span>,<span data-ref-id='sv28fcl2gg'>3</span></sup></li><li>For severe hypercalcemia (&gt; 14 mg/dL), immediate treatment is required, including IV rehydration with normal saline, calcitonin (4-8 units/kg subcutaneously or intramuscularly every 6-12 hours for 48-72 hours), and bisphosphonates or denosumab. Calcitonin provides rapid calcium reduction within 6 hours but should not be used for more than 48-72 hours due to tachyphylaxis.<sup data-type='references'><span data-ref-id='avt4dht8j7'>2</span>,<span data-ref-id='9d3a1552je'>4</span></sup></li><li>Regular monitoring of serum calcium levels is essential during treatment.<sup data-type='references'><span data-ref-id='avt4dht8j7'>2</span>,<span data-ref-id='sv28fcl2gg'>3</span></sup></li></ul>",
        "answerFound": true,
        "conversationId": "2026-01-14-baf70a9f-7d0b-4c9c-a96a-3f1d53a9db61",
        "messageId": "1",
        "disclaimer": {
            "content": "Dyna AI responses are for educational purposes only and should not be solely relied upon for medical practice.",
            "moreContent": "The presentation of a response does not imply any specific ranking by importance or probability and a response may not include all possibly relevant material. Interpretation and application are subject to the judgment of a healthcare professional. Dyna AI responses are not intended to serve as recommendations for individual patients. Do not enter Protected Health Information (PHI)."
        },
        "references": {
            "title": "DynaMedex Sources",
            "hasNotes": false,
            "results": [
                {
                    "slug": "/condition/hypercalcemia-1",
                    "title": "Hypercalcemia >",
                    "sections": [
                        {
                            "title": "Malignancy",
                            "slug": "/condition/hypercalcemia-1",
                            "anchor": "MALIGNANCY",
                            "breadcrumb": "Background Information > Etiology and Pathogenesis > Causes > Conditions Associated With Increased Bone Resorption >",
                            "refIndex": 1,
                            "metadata": {
                                "title": "Hypercalcemia",
                                "navigateTo": [
                                    "Background Information",
                                    "Etiology and Pathogenesis",
                                    "Causes",
                                    "Conditions Associated With Increased Bone Resorption",
                                    "Malignancy"
                                ],
                                "id": "T116018",
                                "pubType": {
                                    "pretty": "Condition",
                                    "id": "condition",
                                    "group": "articles"
                                }
                            }
                        },
                        {
                            "title": "Management",
                            "slug": "/condition/hypercalcemia-1",
                            "anchor": "OVERVIEW_MANAGEMENT",
                            "breadcrumb": "Overview and Recommendations >",
                            "refIindex": 2,
                            "metadata": {
                                "title": "Hypercalcemia",
                                "navigateTo": [
                                    "Overview and Recommendations",
                                    "Management"
                                ],
                                "id": "T116018",
                                "pubType": {
                                    "pretty": "Condition",
                                    "id": "condition",
                                    "group": "articles"
                                }
                            }
                        },
                        {
                            "title": "Management Overview",
                            "slug": "/condition/hypercalcemia-1",
                            "anchor": "TREATMENT_OVERVIEW",
                            "breadcrumb": "Management >",
                            "refIndex": 3,
                            "metadata": {
                                "title": "Hypercalcemia",
                                "navigateTo": [
                                    "Management",
                                    "Management Overview"
                                ],
                                "id": "T116018",
                                "pubType": {
                                    "pretty": "Condition",
                                    "id": "condition",
                                    "group": "articles"
                                }
                            }
                        }
                    ],
                    "hasNote": false,
                    "metadata": {
                        "title": "Hypercalcemia",
                        "id": "T116018"
                    }
                },
                {
                    "slug": "/management/palliative-care-or-end-of-life-care-for-adults-in-the-emergency-department",
                    "title": "Palliative Care or End-of-Life Care for Adults in the Emergency Department >",
                    "sections": [
                        {
                            "title": "Hypercalcemia of Malignancy",
                            "slug": "/management/palliative-care-or-end-of-life-care-for-adults-in-the-emergency-department",
                            "anchor": "TOPIC_KHW_5KH_FPB",
                            "breadcrumb": "Disease States for Which Palliative Care May Be Sought >",
                            "index": "4",
                            "metadata": {
                                "title": "Palliative Care or End-of-Life Care for Adults in the Emergency Department",
                                "navigateTo": [
                                    "Disease States for Which Palliative Care May Be Sought",
                                    "Hypercalcemia of Malignancy"
                                ],
                                "id": "T1614007472019",
                                "pubType": {
                                    "pretty": "Management",
                                    "id": "management",
                                    "group": "articles"
                                }
                            }
                        }
                    ],
                    "hasNote": false,
                    "metadata": {
                        "title": "Palliative Care or End-of-Life Care for Adults in the Emergency Department",
                        "id": "T1614007472019"
                    }
                }
            ]
        },
        "media": {
            "algorithms": {
                "title": "Algorithms:",
                "results": [
                    {
                        "id": "A1655215417932",
                        "publicId": "EBSCOHealth/CCMS/Dynamed/images/A1655215417932",
                        "title": "Hypercalcemia diagnosis algorithm",
                        "description": "Adapted from Pediatr Nephrol. 2018 Sep;33(9):1475-1488, Clin Med. (Lond) 2017 Jun;17(3):270-273, BMJ. 2015 Jun 2;350:h2723. Last reviewed 2025. ",
                        "pubType": "algorithm",
                        "copyright": "Copyright ©2025 EBSCO Information Services.",
                        "format": "svg",
                        "alt": "Adapted from Pediatr Nephrol. 2018 Sep;33(9):1475-1488, Clin Med. (Lond) 2017 Jun;17(3):270-273, BMJ. 2015 Jun 2;350:h2723. Last reviewed 2025. ",
                        "links": [
                          {
                            "rel": "external",
                            "href": "https://media.ebsco.healthcare/eis-live/image/authenticated/t_s200/v1/EBSCOHealth/CCMS/Dynamed/images/I1616935757565.jpg?__cld_token__=exp=1769097593~hmac=b41cb9b509d99d4d4ee68605a7f781cb77733f8e825789d9ea53894485515013",
                            "size": "small"
                          }
                        ],
                        "telemetryData": {
                            "id": "A1655215417932",
                            "title": "Hypercalcemia diagnosis algorithm",
                            "format": "svg"
                        }
                    }
                ]
            }
        },
        "recommendedQuestions": [],
        "recommendedContent": {
            "title": "Recommended Content",
            "hasNotes": false,
            "results": []
        },
        "followupQuestions": {
            "title": "Ask a Follow-up",
            "enabled": true
        },
        "streamComplete": true,
        "telemetryData": {
            "searchTerm": "How is it managed",
            "question": "How is hypercalcemia managed in a 35-year-old woman with squamous cell lung cancer, granulomatous TB, and abnormal lab values?",
            "pageToken": "2026-01-14-baf70a9f-7d0b-4c9c-a96a-3f1d53a9db61",
            "conversationId": "2026-01-14-baf70a9f-7d0b-4c9c-a96a-3f1d53a9db61",
            "messageId": "1",
            "searchTimeInMs": 131,
            "ragResponseTimeInMs": 18589,
            "userIntentTimeInMs": 848,
            "answerFound": true,
            "answerNotFound": false,
            "userIntentCategory": "DM_MANAGEMENT_TREATMENT",
            "conceptCount": 2,
            "disclaimer": false,
            "algorithmCount": 1,
            "createdAt": "2026-01-16T18:53:57.782Z"
        }
    }
}

Example Second Follow Up Request

The follow up question to the first two might be "can I use aspirin to treat copd?". The response will be similar to the response above with the same conversationId, but a new messageId.

{
  "criteria": {
    "query": "What are the risks involved?",
    "conversationId": "2026-01-14-baf70a9f-7d0b-4c9c-a96a-3f1d53a9db61",
    "messageId": "1",
    "history": [
        {
            "query": "what is the cause of hypercalcemia in a 35 year old woman with squamous cell lung cancer, granulomatous TB and abnormal lab values",
            "response": " <ul><li>Hypercalcemia in a 35-year-old woman with squamous cell lung cancer may be caused by ectopic production of parathyroid hormone-related protein (PTHrP) by the tumor, which is the most common cause of hypercalcemia in squamous cell lung cancer.<sup data-type='references'><span data-ref-id='fgn6imbi00'>1</span></sup></li><li>Granulomatous tuberculosis (TB) can lead to hypercalcemia due to elevated calcitriol levels resulting from excessive production or decreased degradation of calcitriol. This results in increased intestinal absorption of calcium and phosphate, enhanced bone resorption, hypercalcemia, and hyperphosphatemia.<sup data-type='references'><span data-ref-id='7cc87o01gj'>2</span></sup></li></ul>",
            "question": "What is the cause of hypercalcemia in a 35-year-old woman with squamous cell lung cancer, granulomatous TB, and abnormal lab values?"
        },
        {
            "query": "How is it managed",
            "question": "How is hypercalcemia managed in a 35-year-old woman with squamous cell lung cancer, granulomatous TB, and abnormal lab values?",
            "answer": " <ul><li>Hypercalcemia in patients with squamous cell lung cancer is often caused by humoral hypercalcemia of malignancy due to the tumor secreting parathyroid hormone-related peptide (PTHrP). Management includes IV rehydration with normal saline (2-4 L/day for 1-3 days) to reduce calcium levels and bisphosphonates, such as pamidronate or zoledronic acid, to suppress osteoclast activity. Denosumab may be considered for patients with renal dysfunction or refractory hypercalcemia.<sup data-type='references'><span data-ref-id='o19iff7j29'>1</span>,<span data-ref-id='avt4dht8j7'>2</span>,<span data-ref-id='sv28fcl2gg'>3</span></sup></li><li>Granulomatous tuberculosis (TB) can cause hypercalcemia due to elevated calcitriol levels, leading to increased intestinal calcium absorption. Management includes glucocorticoid therapy to reduce calcitriol production. If hypercalcemia persists, IV bisphosphonates or denosumab may be added.<sup data-type='references'><span data-ref-id='avt4dht8j7'>2</span>,<span data-ref-id='sv28fcl2gg'>3</span></sup></li><li>For severe hypercalcemia (&gt; 14 mg/dL), immediate treatment is required, including IV rehydration with normal saline, calcitonin (4-8 units/kg subcutaneously or intramuscularly every 6-12 hours for 48-72 hours), and bisphosphonates or denosumab. Calcitonin provides rapid calcium reduction within 6 hours but should not be used for more than 48-72 hours due to tachyphylaxis.<sup data-type='references'><span data-ref-id='avt4dht8j7'>2</span>,<span data-ref-id='9d3a1552je'>4</span></sup></li><li>Regular monitoring of serum calcium levels is essential during treatment.<sup data-type='references'><span data-ref-id='avt4dht8j7'>2</span>,<span data-ref-id='sv28fcl2gg'>3</span></sup></li></ul>",

        }
    ]
  }
}

The subsequent response(s) will follow a similar pattern. Up to 4 follow-on questions can be made. A 422 status code will be returned when you set the messageId to 5 and attempt another question.

Media in Response

When an answer has media, each media resource will contain a secure link. The secure link is to a small resolution for that media that is only valid for 24 hours.

Specifying Image and Video Image Sizes

Links to images and algorithms of varying sizes may be returned in the article response. To specify the image size, add one or more imageSize query parameters to the call. small (thumbnail size) is the default, medium (500w), large (1000w) and full image sizes are supported. For some use cases, non-expiring media links are required. In this case, mediaLinksFormat can be set to "server", which will return a secure link to the image or algorithm in its original size. The link will include the file type. By default, mediaLinksFormat is set to "browser", and does not need to be specified.

For media returning svg files, small, medium and large will be returned as png files. Full can return the svg file unless convertSvg is set to true.

Parameter NameDescription
imageSizeReturns the requested size.
mediaLinksFormatReturns a secure link in its original size. Options are server or browser (default).
convertSvgReturn images and algorithms that are originally in svg format as png format.

Superscripts in a Query

When the user has asked a question, the response may have html within it. The caller can expect any valid HTML in the answer. However, these tags are more likely to occur:

<ul>,<li>,<ol>,<strong>,<b>,<em>,<sub>,<sup>,<a>, and <br>.

An example is below.

{
  "criteria": {
    "query": "chads 2 vac score"
  }
}

The answer would look like this:

"answer":" The CHA<sub>2</sub>DS<sub>2</sub>-VASc score is a clinical prediction tool used to estimate the risk of stroke in patients with atrial fibrillation. It assigns points based on the presence of certain risk factors:<br><ul><li>Congestive heart failure or left ventricular dysfunction - 1 point</li><li>Hypertension - 1 point</li><li>Age ≥ 75 years - 2 points</li><li>Diabetes mellitus....

Request for Malicious or Non-Medical Information

A request for information that falls outside of the DynaMedex guardrailed content will fail.

{
  "criteria": {
     "query": "How do I make a peach cobbler?"
  }
}
{
    "viewModel": {
        "conceptCount": 0,
        "supported": true,
        "query": "How do I make a peach cobbler?",
        "question": "",
        "answer": "",
        "answerFound": false,
        "conversationId": "2026-01-16-b9faf559-8189-4c50-b146-069bf8d4cfac",
        "messageId": "0",
        "disclaimer": {
            "content": "Dyna AI responses are for educational purposes only and should not be solely relied upon for medical practice.",
            "moreContent": "The presentation of a response does not imply any specific ranking by importance or probability and a response may not include all possibly relevant material. Interpretation and application are subject to the judgment of a healthcare professional. Dyna AI responses are not intended to serve as recommendations for individual patients. Do not enter Protected Health Information (PHI)."
        },
        "references": {
            "title": "DynaMedex Sources",
            "hasNotes": false,
            "results": []
        },
        "recommendedQuestions": [],
        "recommendedContent": {
            "title": "Recommended Content",
            "hasNotes": false,
            "results": []
        },
        "followupQuestions": {
            "title": "Ask a Follow-up",
            "enabled": false
        },
        "streamComplete": true,
        "telemetryData": {
            "searchTerm": "How do I make a peach cobbler?",
            "question": "",
            "pageToken": "2026-01-16-b9faf559-8189-4c50-b146-069bf8d4cfac",
            "conversationId": "2026-01-16-b9faf559-8189-4c50-b146-069bf8d4cfac",
            "messageId": "0",
            "searchTimeInMs": 0,
            "ragResponseTimeInMs": 0,
            "userIntentTimeInMs": 0,
            "answerFound": false,
            "answerNotFound": true,
            "error": "MALICIOUS",
            "conceptCount": 0,
            "disclaimer": false,
            "createdAt": "2026-01-16T19:06:43.960Z"
        }
    }
}

The error indicates that the answer can't be found in our content.

Disclaimers

It is possible that an answer may contain a disclaimer. In the case below, the response will direct the user to locate a page with more information.

{
  "criteria": {
    "query": "Is it safe to co-administer methadone and rifampin to a patient?"
  }
}
{
    "viewModel": {
        "conceptCount": 7,
        "supported": true,
        "query": "Is it safe to co-administer methadone and rifampin to a patient?",
        "question": "Is it safe to co-administer methadone and rifampin to a patient?",
        "answer": "We're sorry, Dyna AI does not currently answer this type of question. Use the Drug Interaction Checker to get detailed drug interaction information.",
        "answerFound": true,
        "conversationId": "2026-01-16-754aa2f4-da20-4525-b397-3a75da17347d",
        "messageId": "0",
        "disclaimer": {
            "content": "Dyna AI responses are for educational purposes only and should not be solely relied upon for medical practice.",
            "moreContent": "The presentation of a response does not imply any specific ranking by importance or probability and a response may not include all possibly relevant material. Interpretation and application are subject to the judgment of a healthcare professional. Dyna AI responses are not intended to serve as recommendations for individual patients. Do not enter Protected Health Information (PHI)."
        },
        "references": {
            "title": "DynaMedex Sources",
            "hasNotes": false,
            "results": []
        },
        "recommendedQuestions": [],
        "recommendedContent": {
            "title": "Recommended Content",
            "hasNotes": false,
            "results": []
        },
        "followupQuestions": {
            "title": "Ask a Follow-up",
            "enabled": true
        },
        "streamComplete": true,
        "telemetryData": {
            "searchTerm": "Is it safe to co-administer methadone and rifampin to a patient?",
            "question": "Is it safe to co-administer methadone and rifampin to a patient?",
            "pageToken": "2026-01-16-754aa2f4-da20-4525-b397-3a75da17347d",
            "conversationId": "2026-01-16-754aa2f4-da20-4525-b397-3a75da17347d",
            "messageId": "0",
            "searchTimeInMs": 0,
            "ragResponseTimeInMs": 0,
            "userIntentTimeInMs": 865,
            "answerFound": true,
            "answerNotFound": false,
            "userIntentCategory": "DM_INTERACTIONS",
            "conceptCount": 7,
            "disclaimer": true,
            "createdAt": "2026-01-16T19:08:00.544Z"
        }
    }
}

The answer directs the user to check the Drug Interaction Checker instead. The userIntentCategory further identifies the type of disclaimer.

Disclaimer Examples:

  • What is the appropriate dose of caffeine for treating apnea of maturity?
    • "answer":"Please use NeoFax Pediatrics for more detailed information regarding pediatric and neonatal dosing."
    • "userIntentCategory":"DM_DOSE_PEDS"
  • Are meropenem and midazolam IV compatible?
    • "answer":"Please use the IV Compatibility Module for detailed IV compatibility information."
    • "userIntentCategory":"DM_IV_COMPATIBILITY"
  • What are the treatment options for strep throat in a patient with an allergy to amoxicillin?
    • "answer":"We're sorry but we were unable to find the answer in DynaMedex"
    • "userIntentCategory":"DM_ALLERGY"
  • Are any medications in the R-CHOP regimen classified as vesicants?
    • "answer":"We're sorry but we were unable to find the answer in DynaMedex"
    • "userIntentCategory":"DM_CHEMO"

Internal System Error

In the event that Dyna was unable to complete, you may receive an internal system error once the streaming has started. Additional status code information is below.

{
  "viewModel": {
    "query": "copd treatment",
    "answer": "",
    "answerNotFound": true,
    "telemetryData": {
      "error": "System error"
    },
    "streamComplete": true
  }
}

The DynaMed/DynaMedex search/rag endpoint can return one of the error response codes.