Decision Support System Indexed by Drug (HAS)

Introduction

The getSam request retrieves alerts indexed to a clinical drug (aka virtual drug), a branded drug (CIS), a packaged drug or an ingredient linked by the French National Authority for Health (HAS).

Entry Point

post/aort/v1/graphql

HTTP Headers

Name	Value
`Content-Type`	`application/json`
`Authorization`	`Bearer <token>`

Arguments

These results are obtained through the analysis API. You need to provide a list of drugs (clinical, branded or packaged drug) to the getSam request via the drugs argument.

Argument	Input field	Type	Description
`drugs`		`DrugInput[]`	List of drugs to analyze
`patient`	`conditions`	`ConditionInput[]`	Patient Pathologies and Conditions (SNOMED)
`patient`	`sex`	`Gender`	Biological sex of the patient
`patient`	`birthDate`	`Date`	Patient’s date of birth
`patient`	`continuousCriteria`	`ContinuousCriterionInput[]`	Patient biological parameters
`patient`	`concurrentTreatments`	`TreatmentInput`	Pre-existing treatments in the patient
`patient`	`ageGroups`	`AgeGroup[]`	Age category concerned. The different possible values are: Premature, Newborn (0 to 1 month), Infant (1 to 24 months), Child (0 months to 18 years), Adolescent (12 to 18 years), Adult (> 17 years) and Senior (> 64 years old)
`patient`	`observations`	`ObservationInput[]`	List of observations for the patient
`softwareTypes`		`TargetedTherapySoftware[]`	List of types of software asking for the decision

Result

The API returns an object of type SamResult.

Attributes	Type	Description
`alert`	`AlertResult`	Alert corresponding to the translation of the triggering algorithm into patient criteria and drugs similar to other Alert objects
`sam`	`Sam`	Object containing all information of the concerned SAM

Example

SAM

query GetSAM($drugs: [DrugInputWithIngredient])
  {
    getSam(drugs: $drugs){
      sam {
        title
        identifier
        messagesForHealthProfessionals {
          softwareType
          text
        }
        alternativeDrug
        status
        source
        contact
        updateDate
        validationDate
        versionNumber
      }
      alert {
        designation
        patient {
          ageGroups
          sex
          continuousCriteria {
            max
            min
            type
            unit
          }
          concurrentTreatments {
            ingredients
            procedures
            therapeuticClasses
          }
        }
      }
    }
  }
}

SAM

{
  "drugs": [
    {
      "clinicalDrug": {
        "code": "MV00003831",
        "terminology": "posos"
      }
    }
  ]
}

Response

{
  "data": {
    "getSam": [
      {
        "sam": {
          "title": "Rendre disponible aux professionnels de santé la fiche médicament sur la prévention et la gestion des effets indésirables du Vismodégib",
          "identifier": "2019_0028_19",
          "messagesForHealthProfessionals": null,
          "alternativeDrug": null,
          "status": "Actif",
          "source": "https://www.e-cancer.fr/Professionnels-de-sante/Medicaments/Prevention-suivi-et-gestion-des-effets-indesirables/Molecules-de-S-a-Z-d.c.i/Vismodegib",
          "contact": "ggrosjean@institutcancer.fr",
          "updateDate": null,
          "validationDate": "2019-02-13",
          "versionNumber": "V1.0"
        },
        "alert": {
          "designation": "Rendre disponible aux professionnels de santé la fiche médicament sur la prévention et la gestion des effets indésirables du Vismodégib",
          "patient": {
            "ageGroups": [],
            "sex": null,
            "continuousCriteria": [],
            "concurrentTreatments": {
              "ingredients": [],
              "procedures": [],
              "therapeuticClasses": []
            }
          }
        }
      }
    ]
  }
}

Enums

Gender

Variable	Description
M	Male
F	Female

AgeGroup

Variable	Description
NEWBORN	Newborn
SENIOR	Senior
CHILD	Child
ADOLESCENT	Adolescent
PREMATURE	Premature
INFANT	Infant
ADULT	Adult

Response Code

Code	Description
`200`	OK
`400`	One of the parameters passed in the request is invalid.

Treatment Recommendation Calculators