Skip to content

Interaction analysis

The getInteractions query allows you to retrieve contraindications linked to a clinical drug (aka virtual drug) or an ingredient.

Entry point

post/aort/v1/graphql

HTTP headers

NameValue
Content-Typeapplication/json
AuthorizationBearer <token>

Variables

VariesInput fieldTypeDescription
drugsDrugInput[]List of drugs to analyze
typesInteractionType[]Interaction type

DrugInputWithIngredient

List of drugs to analyze. The drug is either represented as an ingredient, clinical drug, branded drug or packaged drug.

FieldTypeDescription
clinicalDrugCodingInputCode of the clinical drug
brandedDrugCodingInputCode of the branded drug
packagedDrugCodingInputCode of the packaged drug

Result

The API returns an object of type AlertWithIngredientResult.

InteractionResult

AttributesTypeDescription
designationStringThe designation of the interaction. The designation contains the two trigger groups separated by <>
typeInteractionTypeType of interaction
warningsWarning[]List of warnings
rightDrugDrug responsible for the interaction
leftDrugOther drug responsible for the interaction
sourceSourceSource of interaction

Drug

AttributesTypeDescription
clinicalDrugCodingWithInnCoding of the clinical drug
brandedDrugCodingWithInnCoding of the branded drug
packagedDrugCodingWithInnCoding of the packaged drug

Coding

AttributesTypeDescription
codestringCode of this entity in terminology
labelstringLabel of this entity in terminology
terminologystringTerminology identifier

CodingWithInn

AttributesTypeDescription
codestringCode of this entity in terminology
labelstringLabel of this entity in terminology
terminologystringTerminology identifier
innstringCode of the inn identifier

Warning

AttributesTypeDescription
riskStringRisk of interaction
guidelinesString[]What to do

Source

AttributesTypeDescription
urlstringSearchable URL for this source
authorStringAuthor responsible for this source

Example

Interactions

query getInteractions($drugs: [DrugInputWithIngredient]) {
  getInteractions(drugs: $drugs) {
    designation
    source {
      author
      url
    }
    right {
      clinicalDrug {
        inn
        code
        label
      }
    }
    left {
      clinicalDrug {
        inn
        code
        label
      }
    }
    type
    patient {
      ageGroups
      sex
      continuousCriteria {
        max
        min
        type
        unit
      }
      concurrentTreatments {
        ingredients
        procedures
        therapeuticClasses
      }
    }
    warnings {
      risk
      guidelines
      modifiers
    }
  }
}

Interactions-variables

{
  "drugs": [
    {
      "clinicalDrug": {
        "code": "MV00003865",
        "terminology": "posos"
      }
    },
    {
      "clinicalDrug": {
        "code": "MV00002488",
        "terminology": "posos"
      }
    },
    {
      "clinicalDrug": {
        "code": "MV00000353",
        "terminology": "posos"
      }
    },
    {
      "clinicalDrug": {
        "code": "MV00000806",
        "terminology": "posos"
      }
    },
    {
      "clinicalDrug": {
        "code": "MV00001780",
        "terminology": "posos"
      }
    }
  ]
}

Interactions-response

{
  "data": {
    "getInteractions": [
      {
        "designation": "potassium <> inhibiteurs de l'enzyme de conversion",
        "source": {
          "author": "Thesaurus - ANSM",
          "url": "https://ansm.sante.fr/uploads/2020/10/27/20201027-thesaurus-referentiel-national-des-interactions-medicamenteuses-20102020.pdf"
        },
        "right": {
          "clinicalDrug": {
            "inn": "chlorure de potassium",
            "code": "MV00001780",
            "label": "Potassium chlorure 600 mg gélule à libération prolongée"
          }
        },
        "left": {
          "clinicalDrug": {
            "inn": "ramipril",
            "code": "MV00000353",
            "label": "Ramipril 1,25 mg comprimé"
          }
        },
        "type": "CONCOMITANT_USE_NOT_RECOMMENDED",
        "warnings": [
          {
            "risk": "Pour une quantité de potassium > à 1 mmol/prise, hyperkaliémie potentiellement létale, notamment chez l'insuffisant rénal (addition des effets hyperkaliémiants).",
            "guidelines": [
              "Sauf s'il existe une hypokaliémie."
            ],
            "modifiers": []
          }
        ]
      },
      {
        "designation": "hyperkaliémiants <> autres hyperkaliémiants",
        "source": {
          "author": "Thesaurus - ANSM",
          "url": "https://ansm.sante.fr/uploads/2020/10/27/20201027-thesaurus-referentiel-national-des-interactions-medicamenteuses-20102020.pdf"
        },
        "right": {
          "clinicalDrug": {
            "inn": "chlorure de potassium",
            "code": "MV00001780",
            "label": "Potassium chlorure 600 mg gélule à libération prolongée"
          }
        },
        "left": {
          "clinicalDrug": {
            "inn": "ramipril",
            "code": "MV00000353",
            "label": "Ramipril 1,25 mg comprimé"
          }
        },
        "type": "TAKE_INTO_ACCOUNT",
        "warnings": [
          {
            "risk": "Risque de majoration de l’hyperkaliémie, potentiellement létale.",
            "guidelines": [],
            "modifiers": []
          }
        ]
      },
      {
        "designation": "diurétiques hypokaliémiants <> inhibiteurs de l'enzyme de conversion",
        "source": {
          "author": "Thesaurus - ANSM",
          "url": "https://ansm.sante.fr/uploads/2020/10/27/20201027-thesaurus-referentiel-national-des-interactions-medicamenteuses-20102020.pdf"
        },
        "right": {
          "clinicalDrug": {
            "inn": "furosémide",
            "code": "MV00000806",
            "label": "Furosémide 40 mg comprimé"
          }
        },
        "left": {
          "clinicalDrug": {
            "inn": "ramipril",
            "code": "MV00000353",
            "label": "Ramipril 1,25 mg comprimé"
          }
        },
        "type": "PRECAUTION",
        "warnings": [
          {
            "risk": "Risque d'hypotension artérielle brutale et/ou d'insuffisance rénale aiguë lors de l'instauration ou de l'augmentation de la posologie d'un traitement par un inhibiteur de l'enzyme de conversion en cas de déplétion hydrosodée préexistante.",
            "guidelines": [
              "Dans l'hypertension artérielle, lorsqu'un traitement diurétique préalable a pu entraîner une déplétion hydrosodée, il faut : \n- soit arrêter le diurétique avant de débuter le traitement par l'IEC, et réintroduire un diurétique hypokaliémiant si nécessaire ultérieurement ;\n- soit administrer des doses initiales réduites d'IEC et augmenter progressivement la posologie.\n\nDans l'insuffisance cardiaque congestive traitée par diurétiques, commencer par une dose très faible d'IEC, éventuellement après réduction de la dose du diurétique hypokaliémient associé. \n\nDans tous les cas : surveiller la fonction rénale (créatininémie) dans les premières semaines du traitement par l'IEC."
            ],
            "modifiers": []
          }
        ]
      }
    ]
  }
}

Enums

InteractionType

VariableDescription
CONCOMITANT_USE_NOT_RECOMMENDEDConcomitant use not recommended
PRECAUTIONPrecaution of use
TAKE_INTO_ACCOUNTTo take into account
CONTRA_INDICATIONContra-indication

Gender

VariableDescription
MMale
FFemale

AgeGroup

VariableDescription
NEWBORNNewborn
SENIORSenior
CHILDChild
ADOLESCENTAdolescent
PREMATUREPremature
INFANTInfant
ADULTAdult

Response codes

CodeDescription
200OK
400One of the parameters passed in the request is invalid