Hives (urticaria)
Body Request
If you need to analyze an image whose known condition is hives urticaria, you can send a follow up request to the API.
An example of the body of the request can be the following:
{
"requestId": "90925097-820b-403d-a75d-4cd989903df1",
"data": {
"type": "image",
"modality": "clinical",
"operator": "Practitioner",
"bodySite": "ARM_LEFT",
"knownConditionForThisImage": {
"conclusion": "Hives urticaria"
},
"subject": {
"identifier": "6ec724a0-6fa3-11eb-a15f-0242ac160004",
"gender": "m",
"height": 175,
"weight": 71,
"birthdate": "1986-10-21",
"generalPractitioner": {
"identifier": "44f89a8c-6f8a-11eb-9c8a-0242ac160004"
},
"managingOrganization": {
"identifier": "b13cd636-327b-11ec-86b0-0242ac180004",
"display": "Hospital Central"
}
},
"scoringSystems": ["AUAS_LOCAL", "UAS_LOCAL", "DLQI", "UCT"],
"questionnaireResponse": {
"DLQI": {
"question1": 2,
"question2": 3,
"question3": 1,
"question4": 2,
"question5": 1,
"question6": 2,
"question7": 2,
"question8": 2,
"question9": 3,
"question10": 2
},
"AUAS_LOCAL": {
"itchiness": 1
},
"UAS_LOCAL": {
"itchiness": 1,
"hiveNumber": 12
},
"UCT": {
"question1Uct": "2",
"question2Uct": "3",
"question3Uct": "1",
"question4Uct": "2"
}
},
"previousMedia": [
{
"content": "base64 image",
"date": "2022-02-22T12:16:59+01:00"
}
],
"content": "base64 image"
}
}
This is the description of the relevant properties of the body request:
bodySiteis the body site code identifying the zone where the photo was taken. You can find the available list with all the admitted codes here.knownConditionForThisImageis set to the codeHives urticaria, so the API will run the specific algorithms related to this pathology.previousMediais not mandatory. It is an array with a set of the previous images of the analyzed condition. The AI algorithms use this information to calculate the final report.scoringSystemsis an array with the scoring systems to be calculated. For hives urticaria we support:AUAS_LOCAL, the automatic version of the UASUAS_LOCAL, the PASI scoring system calculated at local level.UCT.DLQI.
questionnaireResponse. See next section 😁
How to fill questionnaireResponse
The property questionnaireResponse must contain all the mandatory answers to each scoring system specified in the property scoringSystems.
For example, if you want the API to compute the DLQI, questionnaireResponse["DLQI"] must contain the ten values corresponding to the ten questions DLQI has.
Questionnaires for scoring systems
In the following snippet you will find the questionnaires related to each scoring system related to Hives urticaria. If you want the AI calculate one of them, you must get from that info from the patient or the practitioner.
[
{
"code": "AUAS_LOCAL",
"questions": [
{
"code": "itchiness",
"label": "Itchiness",
"description": null,
"answers": [
{ "label": "None", "value": "0" },
{ "label": "Mild", "value": "1" },
{ "label": "Moderate", "value": "2" },
{ "label": "Severe", "value": "3" }
],
"openField": false
}
]
},
{
"code": "DLQI",
"questions": [
{
"code": "question1",
"label": "Over the last week, how itchy, sore, painful or stinging has your skin been?",
"description": null,
"answers": [
{ "label": "Not at all", "value": "0" },
{ "label": "A little", "value": "1" },
{ "label": "A lot", "value": "2" },
{ "label": "Very much", "value": "3" }
],
"openField": false
},
{
"code": "question2",
"label": "Over the last week, how embarrassed or self conscious have you been because of your skin?",
"description": null,
"answers": [
{ "label": "Not at all", "value": "0" },
{ "label": "A little", "value": "1" },
{ "label": "A lot", "value": "2" },
{ "label": "Very much", "value": "3" }
],
"openField": false
},
{
"code": "question3",
"label": "Over the last week, how much has your skin interfered with you going shopping or looking after your home or garden? ",
"description": null,
"answers": [
{ "label": "Not at all", "value": "0" },
{ "label": "A little", "value": "1" },
{ "label": "A lot", "value": "2" },
{ "label": "Very much", "value": "3" }
],
"openField": false
},
{
"code": "question4",
"label": "Over the last week, how much has your skin influenced the clothes you wear?",
"description": null,
"answers": [
{ "label": "Not at all", "value": "0" },
{ "label": "A little", "value": "1" },
{ "label": "A lot", "value": "2" },
{ "label": "Very much", "value": "3" }
],
"openField": false
},
{
"code": "question5",
"label": "Over the last week, how much has your skin affected any social or leisure activities?",
"description": null,
"answers": [
{ "label": "Not at all", "value": "0" },
{ "label": "A little", "value": "1" },
{ "label": "A lot", "value": "2" },
{ "label": "Very much", "value": "3" }
],
"openField": false
},
{
"code": "question6",
"label": "Over the last week, how much has your skin made it difficult for you to do any sport?",
"description": null,
"answers": [
{ "label": "Not at all", "value": "0" },
{ "label": "A little", "value": "1" },
{ "label": "A lot", "value": "2" },
{ "label": "Very much", "value": "3" }
],
"openField": false
},
{
"code": "question7",
"label": "Over the last week, how much has your skin prevented you from working or studying?",
"description": null,
"answers": [
{ "label": "Not at all", "value": "0" },
{ "label": "A little", "value": "1" },
{ "label": "A lot", "value": "2" },
{ "label": "Very much", "value": "3" }
],
"openField": false
},
{
"code": "question8",
"label": "Over the last week, how much has your skin created problems with your partner or any of your close friends or relatives?",
"description": null,
"answers": [
{ "label": "Not at all", "value": "0" },
{ "label": "A little", "value": "1" },
{ "label": "A lot", "value": "2" },
{ "label": "Very much", "value": "3" }
],
"openField": false
},
{
"code": "question9",
"label": "Over the last week, how much has your skin caused any sexual difficulties?",
"description": null,
"answers": [
{ "label": "Not at all", "value": "0" },
{ "label": "A little", "value": "1" },
{ "label": "A lot", "value": "2" },
{ "label": "Very much", "value": "3" }
],
"openField": false
},
{
"code": "question10",
"label": "Over the last week, how much of a problem has the treatment for your skin been, for example by making your home messy, or by taking up time?",
"description": null,
"answers": [
{ "label": "Not at all", "value": "0" },
{ "label": "A little", "value": "1" },
{ "label": "A lot", "value": "2" },
{ "label": "Very much", "value": "3" }
],
"openField": false
}
]
},
{
"code": "UCT",
"questions": [
{
"code": "question1Uct",
"label": "How much have you suffered from the physical symptoms of the urticaria (itch, hives and/or swelling) in the last four weeks?",
"description": null,
"answers": [
{ "label": "Very much", "value": "0" },
{ "label": "Much", "value": "1" },
{ "label": "Somewhat", "value": "2" },
{ "label": "A little", "value": "3" },
{ "label": "Not at all", "value": "4" }
],
"openField": false
},
{
"code": "question2Uct",
"label": "How much was your quality of life affected by the urticaria in the last 4 weeks?",
"description": null,
"answers": [
{ "label": "Very much", "value": "0" },
{ "label": "Much", "value": "1" },
{ "label": "Somewhat", "value": "2" },
{ "label": "A little", "value": "3" },
{ "label": "Not at all", "value": "4" }
],
"openField": false
},
{
"code": "question3Uct",
"label": "How often was the treatment for your urticaria in the last 4 weeks not enough to control your urticaria symptoms?",
"description": null,
"answers": [
{ "label": "Very often", "value": "0" },
{ "label": "Often", "value": "1" },
{ "label": "Sometimes", "value": "2" },
{ "label": "Seldom", "value": "3" },
{ "label": "Not at all", "value": "4" }
],
"openField": false
},
{
"code": "question4Uct",
"label": "Overall, how well have you had your urticaria under control in the last 4 weeks?",
"description": null,
"answers": [
{ "label": "Not at all", "value": "0" },
{ "label": "A little", "value": "1" },
{ "label": "Somewhat", "value": "2" },
{ "label": "Well", "value": "3" },
{ "label": "Very well", "value": "4" }
],
"openField": false
}
]
},
{
"code": "UAS_LOCAL",
"questions": [
{
"code": "itchiness",
"label": "Itchiness",
"description": null,
"answers": [
{ "label": "None", "value": "0" },
{ "label": "Mild", "value": "1" },
{ "label": "Moderate", "value": "2" },
{ "label": "Severe", "value": "3" }
],
"openField": false
},
{
"code": "hiveNumber",
"label": "Hive number",
"description": null,
"openField": true
}
]
}
]
Response
{
"category": [
{
"coding": [
{
"code": "250171008",
"display": "Clinical history and observation finding",
"system": "http://snomed.info/sct"
}
]
}
],
"code": {
"coding": [
{
"code": "10206-1",
"display": "Physical findings of Skin Narrative",
"system": "http://loinc.org"
}
]
},
"detectedModality": "Clinical",
"device": {
"deviceName": {
"name": "Legit.Health",
"type": "user-friendly-name"
},
"manufacturer": "AI LABS GROUP SL",
"resourceType": "Device",
"type": {
"code": "string",
"display": "Dermatology picture archiving and communication system application software",
"system": "http://snomed.info/sct"
}
},
"evolution": {
"domains": {
"AUAS_LOCAL": {
"explainabilityMedia": {
"content": "base 64 image",
"detections": [
{
"confidence": 93,
"label": "Hive",
"p1": {
"x": 539,
"y": 266
},
"p2": {
"x": 604,
"y": 329
}
},
{
"confidence": 97,
"label": "Hive",
"p1": {
"x": 463,
"y": 135
},
"p2": {
"x": 561,
"y": 193
}
}
]
},
"facets": {
"hiveNumber": {
"intensity": 0,
"value": 0
},
"itchiness": {
"intensity": 1,
"value": 1
}
},
"grade": {
"category": "Mild",
"score": 1
}
},
"DLQI": {
"explainabilityMedia": {
"content": null,
"detections": null
},
"facets": {
"question1": {
"intensity": null,
"value": 2
},
"question2": {
"intensity": null,
"value": 2
},
"question3": {
"intensity": null,
"value": 2
},
"question4": {
"intensity": null,
"value": 2
},
"question5": {
"intensity": null,
"value": 2
},
"question6": {
"intensity": null,
"value": 2
},
"question7": {
"intensity": null,
"value": 2
},
"question8": {
"intensity": null,
"value": 2
},
"question9": {
"intensity": null,
"value": 2
},
"question10": {
"intensity": null,
"value": 2
}
},
"grade": {
"category": "Very large effect on patient's life",
"score": 20
}
},
"UAS_LOCAL": {
"explainabilityMedia": {
"content": null,
"detections": null
},
"facets": {
"hiveNumber": {
"intensity": 0,
"value": 0
},
"itchiness": {
"intensity": 1,
"value": 1
}
},
"grade": {
"category": "Mild",
"score": 1
}
},
"UCT": {
"explainabilityMedia": {
"content": null,
"detections": null
},
"facets": {
"question1Uct": {
"intensity": null,
"value": 2
},
"question2Uct": {
"intensity": null,
"value": 2
},
"question3Uct": {
"intensity": null,
"value": 2
},
"question4Uct": {
"intensity": null,
"value": 2
}
},
"grade": {
"category": "Very large effect on patient's life",
"score": 20
}
}
}
},
"explainabilityMedia": {
"content": "base 64 image",
"modality": "Clinical",
"resourceType": "Media",
"type": "image"
},
"mediaValidity": {
"isValid": true,
"metrics": {
"hasEnoughQuality": true,
"isDermatologyDomain": true
},
"score": 66.0
},
"metrics": {
"category": "calculation",
"resourceType": "DeviceMetric",
"sensitivity": 99.56,
"specificity": 93.99
},
"preliminaryFindings": {
"hasConditionSuspicion": 99.2,
"isMalignantSuspicion": 0,
"isPreMalignantSuspicion": 0.6000000000000001,
"needsBiopsySuspicion": 0,
"needsSpecialistsAttention": 3.86
},
"resourceType": "DiagnosticReport",
"status": "preliminary",
"time": 2.1950724124908447,
"conclusions": [
{
"code": {
"code": "",
"codeSystem": "ICD-11"
},
"name": "Hives urticaria",
"probability": 98.66
},
{
"code": {
"code": "",
"codeSystem": "ICD-11"
},
"name": "Nonspecific lesion",
"probability": 1.34
}
]
}