Psoriasis
Body Request
If you need to analyze an image whose known condition is psoriasis, 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": "Psoriasis"
},
"previousMedia": [
{
"content": "base64 image",
"date": "2022-02-22T12:16:59+01:00"
}
],
"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": ["APASI_LOCAL", "PASI_LOCAL", "DLQI", "PURE4"],
"questionnaireResponse": {
"DLQI": {
"question1": 2,
"question2": 3,
"question3": 1,
"question4": 2,
"question5": 1,
"question6": 2,
"question7": 2,
"question8": 2,
"question9": 3,
"question10": 2
},
"APASI_LOCAL": {
"surface": 1
},
"PASI_LOCAL": {
"surface": 1,
"erythema": 1,
"induration": 2,
"desquamation": 2
},
"PURE4": {
"question1Pure": "0",
"question2Pure": "1",
"question3Pure": "0",
"question4Pure": "0"
}
},
"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 codePsoriasis, 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 psoriasis we support:APASI_LOCAL, the automatic version of the PASI. You can read more here.PASI_LOCAL, the PASI scoring system calculated at local level.PURE4.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 Psoriasis. If you want the AI calculate one of them, you must get from that info from the patient or the practitioner.
[
{
"code": "APASI_LOCAL",
"questions": [
{
"code": "surface",
"label": "Affected area",
"answers": [
{ "label": "0", "value": "0" },
{ "label": "0-10%", "value": "1" },
{ "label": "10-30%", "value": "2" },
{ "label": "30-50%", "value": "3" },
{ "label": "50-70%", "value": "4" },
{ "label": "70-90%", "value": "5" },
{ "label": "90-100%", "value": "6" }
],
"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": "PASI_LOCAL",
"questions": [
{
"code": "surface",
"label": "Affected area",
"description": "Lorem ipsum en",
"answers": [
{ "label": "0", "value": "0" },
{ "label": "0-10%", "value": "1" },
{ "label": "10-30%", "value": "2" },
{ "label": "30-50%", "value": "3" },
{ "label": "50-70%", "value": "4" },
{ "label": "70-90%", "value": "5" },
{ "label": "90-100%", "value": "6" }
],
"openField": false
},
{
"code": "erythema",
"label": "Redness",
"description": null,
"answers": [
{ "label": "None", "value": "0" },
{ "label": "Mild", "value": "1" },
{ "label": "Moderate", "value": "2" },
{ "label": "Severe", "value": "3" },
{ "label": "Very severe", "value": "4" }
],
"openField": false
},
{
"code": "induration",
"label": "Induration",
"description": null,
"answers": [
{ "label": "None", "value": "0" },
{ "label": "Mild", "value": "1" },
{ "label": "Moderate", "value": "2" },
{ "label": "Severe", "value": "3" },
{ "label": "Very severe", "value": "4" }
],
"openField": false
},
{
"code": "desquamation",
"label": "Desquamation",
"description": null,
"answers": [
{ "label": "None", "value": "0" },
{ "label": "Mild", "value": "1" },
{ "label": "Moderate", "value": "2" },
{ "label": "Severe", "value": "3" },
{ "label": "Very severe", "value": "4" }
],
"openField": false
}
]
},
{
"code": "PURE4",
"questions": [
{
"code": "question1Pure",
"label": "Have you ever had a globally swollen and painful finger or toe?",
"description": null,
"answers": [
{ "label": "No", "value": "0" },
{ "label": "Yes", "value": "1" }
],
"openField": false
},
{
"code": "question2Pure",
"label": "Have you ever had heel pain as soon as you stand up in the morning?",
"description": null,
"answers": [
{ "label": "No", "value": "0" },
{ "label": "Yes", "value": "1" }
],
"openField": false
},
{
"code": "question3Pure",
"label": "Have you ever had left and right buttock pain, at the same time or not?",
"description": null,
"answers": [
{ "label": "No", "value": "0" },
{ "label": "Yes", "value": "1" }
],
"openField": false
},
{
"code": "question4Pure",
"label": "Have you ever had a swollen and painful joint? (hands, feet, knees, or ankles, for example)",
"description": null,
"answers": [
{ "label": "No", "value": "0" },
{ "label": "Yes", "value": "1" }
],
"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": {
"APASI_LOCAL": {
"explainabilityMedia": {
"content": "base 64 image",
"detections": null
},
"facets": {
"desquamation": {
"intensity": 0,
"value": 0
},
"erythema": {
"intensity": 0,
"value": 0
},
"induration": {
"intensity": 0,
"value": 0
},
"surface": {
"intensity": 1,
"value": 10
}
},
"grade": {
"category": "None",
"score": 0.0
}
},
"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
}
},
"PASI_LOCAL": {
"explainabilityMedia": {
"content": null,
"detections": null
},
"facets": {
"desquamation": {
"intensity": null,
"value": 0
},
"erythema": {
"intensity": null,
"value": 0
},
"induration": {
"intensity": null,
"value": 0
},
"surface": {
"intensity": null,
"value": 10
}
},
"grade": {
"category": "None",
"score": 0.0
}
},
"PURE4": {
"explainabilityMedia": {
"content": null,
"detections": null
},
"facets": {
"question1Pure": {
"intensity": null,
"value": 1
},
"question2Pure": {
"intensity": null,
"value": 1
},
"question3Pure": {
"intensity": null,
"value": 1
},
"question3Pure": {
"intensity": null,
"value": 1
}
},
"grade": {
"category": "Possible psoriatic arthritis",
"score": 4
}
}
}
},
"explainabilityMedia": {
"content": "base64 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": 6.386033296585083,
"conclusions": [
{
"code": {
"code": "",
"codeSystem": "ICD-11"
},
"name": "Psoriasis",
"probability": 98.66
},
{
"code": {
"code": "",
"codeSystem": "ICD-11"
},
"name": "Nonspecific lesion",
"probability": 1.34
}
]
}