Skip to main content

Questionnaires

Each pathology or condition may be associated with one or more scoring systems. These scoring systems can either be calculated automatically through AI model analysis of the image or may require responses to specific questions from the patient or doctor. The /severity-assessment/* endpoints trigger the calculation of these scoring systems.

This endpoint helps to:

  • Identify if any scoring systems are associated with a particular pathology or condition, and provide details about them.
  • Provide information about associated questionnaires, including the content of the questions and available answer options.

By providing the pathology query parameter with an ICD-11 code (e.g., EA90 for Psoriasis), users can obtain relevant scoring systems and questionnaires tailored to the pathology or condition.

The ICD-11 code is returned by the /diagnosis-support endpoint.

GEThttps://medical-device-params.legit.health/v2.0/questionnaires🔓 No Authentication
pathologystringRequired

The ICD-11 code representing the specific pathology for which the questionnaire is needed. For example, EA90 represents Psoriasis.

identifierstring

A unique identifier for each scoring system. It helps integrators understand the results but is not required for endpoint requests. For example, apasiLocal or pure4.

codestring

The short identifier for the scoring system. This key is used in the body of your request to the severity-assessment endpoint. For example, apasi or pure4.

modestring

Specifies whether the assessment is for local or global use. Values: local (for specific body areas) or global (for the whole body).

pathstring

The endpoint URL for querying severity assessment information. For example: /severity-assessment/image-based/local or /severity-assessment/text-based.

titleobject

The title of the assessment tool in multiple languages. Contains language codes (e.g., en_GB, es_ES) as keys with translated titles as values.

descriptionobject

A short description of the tool in multiple languages. Contains language codes (e.g., en_GB, es_ES) as keys with translated descriptions as values.

questionnairearray

An array of questions included in the assessment tool. Each question object contains keys defining the question and its input type.

codestring

A unique identifier for the question.

nameobject

The question text in multiple languages. Contains language codes as keys with translated question text as values.

descriptionobject

Additional information about the question in multiple languages.

inputobject

Defines the input type and constraints (e.g., number, select).

typestring

The input type (e.g., number, select).

minnumber

The minimum value for numeric input (if applicable).

maxnumber

The maximum value for numeric input (if applicable).

optionsarray

An array of possible options for a select input (for example, Yes/No options).

Example request
import requests


url = "https://medical-device-params.legit.health/v2.0/questionnaires"
params = {
  "pathology": "EA90"  # ICD-11 code for Psoriasis
}


response = requests.get(url, params=params)
data = response.json()


print(data)
Response
[
{
  "identifier": "apasiLocal",
  "code": "apasi",
  "mode": "local",
  "path": "/severity-assessment/image-based/local",
  "title": {
    "en_GB": "Local automatic psoriasis area and severity index",
    "es_ES": "Índice automático de gravedad y área de psoriasis local"
  },
  "description": {
    "en_GB": "Clinical tool for a precise psoriasis severity assessment",
    "es_ES": "Herramienta clínica para determinar la gravedad de la psoriasis"
  },
  "questionnaire": [
    {
      "code": "surface",
      "name": {
        "en_GB": "Affected area",
        "es_ES": "Área afectada"
      },
      "description": {
        "en_GB": "This value corresponds to the percentage of involvement of the specific area of the body you are reporting",
        "es_ES": "Este valor corresponde al porcentaje de afectación de la zona concreta del cuerpo que estás reportando"
      },
      "input": {
        "type": "number",
        "min": 0,
        "max": 100
      }
    }
  ]
}
]