Atopic dermatitis
Body Request
If you need to analyze an image whose known condition is atopic dermatitis, 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": "Atopic dermatitis"
},
"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": ["ASCORAD_LOCAL", "SCORAD_LOCAL", "DLQI"],
"questionnaireResponse": {
"DLQI": {
"question1": 2,
"question2": 3,
"question3": 1,
"question4": 2,
"question5": 1,
"question6": 2,
"question7": 2,
"question8": 2,
"question9": 3,
"question10": 2
},
"ASCORAD_LOCAL": {
"surfaceValue": 27,
"itchinessScorad": 2,
"sleeplessness": 2
},
"SCORAD_LOCAL": {
"surfaceValue": 27,
"itchinessScorad": 2,
"sleeplessness": 2,
"erythema": 2,
"swelling": 2,
"crusting": 1,
"excoriation": 1,
"lichenification": 1,
"dryness": 1
}
},
"content": "base64 image",
"previousMedia": [
{
"content": "base64 image",
"date": "2022-02-22T12:16:59+01:00"
}
]
}
}
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 codeAtopic dermatitis, 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 atopic dermatitis we support:ASCORAD_LOCAL, the automatic version of the SCORAD. You can read more here.SCORAD_LOCAL, the SCORAD scoring system calculated at local level.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 Atopic Dermatitis. If you want the AI calculate one of them, you must get from that info from the patient or the practitioner.
[
{
"code": "ASCORAD_LOCAL",
"questions": [
{
"code": "surfaceValue",
"label": "Affected area",
"description": "",
"openField": true
},
{
"code": "itchinessScorad",
"label": "Itchiness",
"description": null,
"answers": [
{ "label": "0", "value": "0" },
{ "label": "1", "value": "1" },
{ "label": "2", "value": "2" },
{ "label": "3", "value": "3" },
{ "label": "4", "value": "4" },
{ "label": "5", "value": "5" },
{ "label": "6", "value": "6" },
{ "label": "7", "value": "7" },
{ "label": "8", "value": "8" },
{ "label": "9", "value": "9" },
{ "label": "10", "value": "10" }
],
"openField": false
},
{
"code": "sleeplessness",
"label": "Sleeplessness",
"description": null,
"answers": [
{ "label": "0", "value": "0" },
{ "label": "1", "value": "1" },
{ "label": "2", "value": "2" },
{ "label": "3", "value": "3" },
{ "label": "4", "value": "4" },
{ "label": "5", "value": "5" },
{ "label": "6", "value": "6" },
{ "label": "7", "value": "7" },
{ "label": "8", "value": "8" },
{ "label": "9", "value": "9" },
{ "label": "10", "value": "10" }
],
"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": "SCORAD_LOCAL",
"questions": [
{
"code": "surfaceValue",
"label": "Affected area",
"description": "",
"openField": true
},
{
"code": "erythema",
"label": "Redness",
"description": null,
"answers": [
{ "label": "None", "value": "0" },
{ "label": "Mild", "value": "1" },
{ "label": "Moderate", "value": "2" },
{ "label": "Severe", "value": "3" }
],
"openField": false
},
{
"code": "swelling",
"label": "Swelling",
"description": null,
"answers": [
{ "label": "None", "value": "0" },
{ "label": "Mild", "value": "1" },
{ "label": "Moderate", "value": "2" },
{ "label": "Severe", "value": "3" }
],
"openField": false
},
{
"code": "crusting",
"label": "Crusting",
"description": null,
"answers": [
{ "label": "None", "value": "0" },
{ "label": "Mild", "value": "1" },
{ "label": "Moderate", "value": "2" },
{ "label": "Severe", "value": "3" }
],
"openField": false
},
{
"code": "excoriation",
"label": "Excoriation",
"description": null,
"answers": [
{ "label": "None", "value": "0" },
{ "label": "Mild", "value": "1" },
{ "label": "Moderate", "value": "2" },
{ "label": "Severe", "value": "3" }
],
"openField": false
},
{
"code": "lichenification",
"label": "Lichenification",
"description": null,
"answers": [
{ "label": "None", "value": "0" },
{ "label": "Mild", "value": "1" },
{ "label": "Moderate", "value": "2" },
{ "label": "Severe", "value": "3" }
],
"openField": false
},
{
"code": "dryness",
"label": "Dryness",
"description": null,
"answers": [
{ "label": "None", "value": "0" },
{ "label": "Mild", "value": "1" },
{ "label": "Moderate", "value": "2" },
{ "label": "Severe", "value": "3" }
],
"openField": false
},
{
"code": "itchinessScorad",
"label": "Itchiness",
"description": null,
"answers": [
{ "label": "0", "value": "0" },
{ "label": "1", "value": "1" },
{ "label": "2", "value": "2" },
{ "label": "3", "value": "3" },
{ "label": "4", "value": "4" },
{ "label": "5", "value": "5" },
{ "label": "6", "value": "6" },
{ "label": "7", "value": "7" },
{ "label": "8", "value": "8" },
{ "label": "9", "value": "9" },
{ "label": "10", "value": "10" }
],
"openField": false
},
{
"code": "sleeplessness",
"label": "Sleeplessness",
"description": null,
"answers": [
{ "label": "0", "value": "0" },
{ "label": "1", "value": "1" },
{ "label": "2", "value": "2" },
{ "label": "3", "value": "3" },
{ "label": "4", "value": "4" },
{ "label": "5", "value": "5" },
{ "label": "6", "value": "6" },
{ "label": "7", "value": "7" },
{ "label": "8", "value": "8" },
{ "label": "9", "value": "9" },
{ "label": "10", "value": "10" }
],
"openField": false
}
]
}
]
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": {
"ASCORAD_LOCAL": {
"explainabilityMedia": {
"content": "base 64 image",
"detections": null
},
"facets": {
"crusting": {
"intensity": 0,
"value": 0
},
"dryness": {
"intensity": 0,
"value": 0
},
"erythema": {
"intensity": 0,
"value": 0
},
"excoriation": {
"intensity": 0,
"value": 0
},
"lichenification": {
"intensity": 0,
"value": 0
},
"surfaceValue": {
"intensity": 2,
"value": 27
},
"swelling": {
"intensity": 0,
"value": 0
},
"itchinessScorad": {
"intensity": 0,
"value": 0
},
"sleeplessness": {
"intensity": 0,
"value": 0
}
},
"grade": {
"category": "Mild",
"score": 4.486
}
},
"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
}
},
"SCORAD_LOCAL": {
"explainabilityMedia": {
"content": null,
"detections": null
},
"facets": {
"crusting": {
"intensity": null,
"value": 0
},
"dryness": {
"intensity": null,
"value": 0
},
"erythema": {
"intensity": null,
"value": 0
},
"excoriation": {
"intensity": null,
"value": 0
},
"lichenification": {
"intensity": 0,
"value": 0
},
"surfaceValue": {
"intensity": null,
"value": 27
},
"swelling": {
"intensity": null,
"value": 0
},
"itchinessScorad": {
"intensity": null,
"value": 0
},
"sleeplessness": {
"intensity": null,
"value": 0
}
},
"grade": {
"category": "Mild",
"score": 4.486
}
}
}
},
"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.5790834426879883,
"conclusions": [
{
"code": {
"code": "",
"codeSystem": "ICD-11"
},
"name": "Atopic dermatits",
"probability": 98.66
},
{
"code": {
"code": "",
"codeSystem": "ICD-11"
},
"name": "Nonspecific lesion",
"probability": 1.34
}
]
}