Skip to main content

ASCORAD

info
Some items of this scoring system can be extracted automatically from the image. However, please read carefully the documentation because this system contains non-visual items such as itchiness or sleeplesness. Since this is the case, you will need to provide the questionnaireResponse of those items inside your request.

Request ASCORAD score​

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:

Relevant keys in the body of the request
"data": {
  "type": "image",
  "content": "base64 image",
  "knownConditionForThisImage": {
    "conclusion": "Atopic dermatitis"
  },
  "scoringSystems": ["ASCORAD_LOCAL"],
  "questionnaireResponse": {
    "ASCORAD_LOCAL": {
      "surfaceValue": 27,
      "itchinessScorad": 2,
      "sleeplessness": 2
    }
  }
}
Check out the documentation
It is important that you check out the section Output of this documentation to understand how you should build the request and what will the response look like. Keep in mind that this is a snippet of a larger JSON file.

Questionnaire for scoring system​

Relevant keys in the body of the request
{
  "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
    }
  ]
}

Response​

Relevant keys in the body of the response
"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
      }
    }
  }
}
Check out the documentation
It is important that you check out the section Output of this documentation to understand how you should build the request and what will the response look like. Keep in mind that this is a snippet of a larger JSON file.