XUND API Documentation

GET /v1/contentLibrary

Use this endpoint to get a universal list of all medical items (symptoms & illnesses) from the database

Request

Request header additional fields

Parameter name

Parameter type

Parameter description

language

ClientLanguage

The expected language of the response

Request query parameters

Parameter name

Parameter type

Parameter description

searchTerm

string (localized text)?

URL encoded version of user-entered search term. Results will match this term.

In some cases filtering happens by medical, and not alphabetical logic, therefore the names or descriptions of results might not match exactly the search term

top

number (integer)?

Keep only first top matching elements. Use for paging support

skip

number (integer)?

Drop first skip matching elements. Use for paging support

isFrequent

boolean?

If provided, only medical items with matching frequency will be returned

Response

Response Body data structure

Property name

Property type

Property description

count

number (integer)

Count of illnesses matching the filters (except top, skip)

items

MedicalItem[]

Results matching the filter parameters

Examples

GET /v1/contentLibrary?top=5&searchTerm=tension%20headache
JSON
{
    "count": 73,
    "items": [
        {
            "id": "3416dc71-b330-4b85-bc21-ef33ba0b3369",
            "name": "Headache",
            "type": "SYMPTOM",
            "description": "Deep pain sensation in the head",
            "detailedDescription": "Pain in the area of the head that can have various manifestations and is often accompanied by other symptoms such as dizziness, sensitivity to light and nausea",
            "isFrequent": true,
            "code": {
                "type": "UMLS",
                "value": "C0018681"
                "coding": [
                    {
                        "code": "C0018681"
                    }
                ],
            }
        },
        {
            "id": "b788966a-fe99-4c5b-8a9e-3a0a2e8fc537",
            "name": "Acute bronchitis",
            "alternativeNames": [
                "Infection of the lower respiratory tract"
            ],
            "type": "ILLNESS",
            "description": "Acute bronchitis is an inflammation of the lower respiratory tract, which is in over 90 percent of cases caused by a viral infection. It usually develops from a simple cold. Acute bronchitis develops when the infection moves to the lower airways. This is when the typical symptoms develop, such as coughing, rales, fever and fatigue. If the symptoms persist for more than two weeks, or if the mucus produced by the cough turns yellowish or greenish or contains traces of blood, a doctor should be consulted. In most cases, acute bronchitis subsides on its own within a few days, but at most within four weeks. ",
            "detailedDescription": "Acute bronchitis is an inflammation of the lower respiratory tract that is caused by a viral infection in over 90 percent of cases. In rare cases, bacteria can also be the trigger for the inflammation, sometimes also fungal infections or harmful gases that have been inhaled. Even though respiratory infections are usually caused by viruses, it often happens that additional bacteria spread on the already damaged mucous membrane. This is called a bacterial superinfection.<br><br>Acute bronchitis usually arises from a simple cold, which manifests itself through symptoms in the upper respiratory tract such as hoarseness and sore throat, and often also through a cold. Acute bronchitis develops when the inflammation moves to the lower airways. Then the typical symptoms develop, such as coughing, rattling breathing noises, often also fever and exhaustion.<br><br>A common cold, along with acute bronchitis, are particularly common in the cold season and are usually harmless. On average, adults develop an infection of the lower respiratory tract once a year, children even several times a year. The infection can usually be cured at home. If the symptoms persist for more than two weeks, or if the mucus produced when coughing becomes yellowish or greenish or contains traces of blood, a doctor should be consulted.",
            "isFrequent": false,
            "iconUrl": "https://cms.development.xund.solutions/image/respiratory.svg",
            "code": {
                "coding": [
                    {
                        "code": "J20"
                    }
                ],
            }
        },
        {
            "id": "114bb0e3-3d63-4b57-9d27-71fb6fdd93e8",
            "name": "Alcohol withdrawal",
            "alternativeNames": [
                "Alcohol withdrawal symptoms"
            ],
            "type": "ILLNESS",
            "description": "Alcohol withdrawal is the first step in the treatment of alcohol dependence. The treatment serves to end the physical dependence on alcohol. Depending on the severity of the addiction, strong physical and psychological symptoms occur. Typical physical symptoms of alcohol withdrawal are heavy sweating, nausea and vomiting, trembling of the hands, eyelids and tongue, dry mouth and general malaise and weakness. Psychological signs are sleep disorders, anxiety, depression and restlessness. There are different methods of alcohol withdrawal. A distinction is made between warm and cold withdrawal. In the case of cold withdrawal, patients must abstain from alcohol without medication. During this time they are under medical observation and care, since an abrupt stop of alcohol can be dangerous for the body. Meanwhile, there are drugs that can significantly reduce withdrawal symptoms. Alcohol consumption is often no longer stopped abruptly, but slowly reduced, which is called warm withdrawal.",
            "detailedDescription": "The term alcohol withdrawal refers to an alcohol abuser's way out of addiction. Under medical supervision, patients first detoxify their bodies in order to overcome their physical dependence. This is usually done as an inpatient in specialised detoxification clinics. The lack of alcohol intake causes the patient's blood alcohol level to drop. After about five to ten hours, so-called alcohol withdrawal symptoms often occur: heartbeat, breathing rate and body temperature increase and many patients experience headaches, shivering and increased sweating.<br><br>Sleep disturbances, feelings of restlessness or anxiety as well as diarrhoea, nausea and vomiting are also typical. After a few days, the symptoms intensify to the point of possible changes in consciousness. Some patients then also suffer from memory disorders, hallucinations or delusions. It is also common to have so-called withdrawal attacks, which are seizures that can be accompanied by wetting and defecation.<br><br>In severe cases, the patient's circulation fails. Most of the time, the withdrawal symptoms subside after a few days. However, they can also persist to a lesser extent over a longer period of more than six months.",
            "isFrequent": false,
            "iconUrl": "https://cms.development.xund.solutions/image/addiction.svg",
            "code": {
                "coding": [
                    {
                        "code": "F10.13"
                    }
                ],
            }
        },
        {
            "id": "03ea9bdb-01f5-425e-8696-a20deb90ed6e",
            "name": "Altitude sickness",
            "alternativeNames": [
                "Mountain sickness"
            ],
            "type": "ILLNESS",
            "description": "Altitude sickness can affect people who climb or travel to altitudes above 2500 meters, especially if they ascend too quickly. As you climb to higher altitudes, the air pressure decreases. At high altitudes, the air still contains the same percentage of oxygen (21%). However, due to the lower air pressure, there is actually less oxygen available because the air is thinner (it contains less of all the gases in a given volume). So at high altitude, each breath contains fewer oxygen molecules. This means that you have to breathe faster and deeper to get enough oxygen into your body. After a few days, the body begins to adapt (acclimate) to the higher altitude. The breathing rate slows down and the body produces more red blood cells to help carry oxygen around the body. Altitude sickness is due to the fact that the body has not yet acclimated to the altitude. In most people, it causes only mild symptoms that improve with rest and time. However, some people may experience more serious symptoms that can become life-threatening. The risk is especially high if the signs are not recognized and the person does not move to a lower altitude.",
            "isFrequent": false,
            "iconUrl": "https://cms.development.xund.solutions/image/injury.svg",
            "code": {
                "coding": [
                    {
                        "code": "T70.2"
                    }
                ],
            }
        },
        {
            "id": "724cef4f-c08d-4740-bb26-1432cff4620a",
            "name": "Arteritis temporalis",
            "alternativeNames": [
                "Giant cell arteritis"
            ],
            "type": "ILLNESS",
            "description": "The giant cell arteritis is an inflammation of the medium-sized and large arteries, meaning the blood vessels coming from the heart. Patients typically suffer from fever and headaches. Their blood shows a reduced number of red blood cells and an increased sedimentation rate. If giant cell arteritis is suspected, the doctor examines the arteries, assessing the pulse, blood flow sounds and blood pressure. Often the affected person shows a pressure sensitive or swollen temporal artery at the temple. The treatment of giant cell arteritis should be carried out as soon as possible after the diagnosis. Since the underlying cause of the disease is still unknown, patients take glucocorticoids under regular supervision for one or more years. In many cases, the affected patients manage without medication after about two years. In about 20 to 25 percent of cases, a significantly longer, sometimes lifelong treatment is necessary.",
            "detailedDescription": "Giant cell arteritis, or GCA for short, is an inflammation of the medium-sized and large arteries, which are blood vessels coming from the heart. Patients typically suffer from fever and headaches. In their blood, they notice a reduced number of red blood cells as well as an increased sedimentation rate.<br><br>Patients often complain of a general feeling of illness, exhaustion, loss of appetite, weight loss, sweating, rheumatic pain, especially in the jaw, shoulder and pelvis, or visual disturbances. The disease often occurs together with the autoimmune disease polymyalgia.<br><br>GCA affects almost exclusively people over 50 years of age and is more common in women than in men. Its frequency increases with advancing age and varies greatly from region to region. It is particularly common in northern regions.",
            "isFrequent": false,
            "iconUrl": "https://cms.development.xund.solutions/image/immune.svg",
            "code": {
                "coding": [
                    {
                        "code": "M31.6"
                    }
                ],
            }
        }
    ]
}