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
Name | Value |
---|---|
Content-Type | application/json |
Authorization | Bearer <token> |
Variables
Varies | Input field | Type | Description |
---|---|---|---|
drugs | DrugInput[] | List of drugs to analyze | |
types | InteractionType[] | Interaction type |
DrugInputWithIngredient
List of drugs to analyze. The drug is either represented as an ingredient, clinical drug, branded drug or packaged drug.
Field | Type | Description |
---|---|---|
clinicalDrug | CodingInput | Code of the clinical drug |
brandedDrug | CodingInput | Code of the branded drug |
packagedDrug | CodingInput | Code of the packaged drug |
Result
The API returns an object of type AlertWithIngredientResult
.
InteractionResult
Attributes | Type | Description |
---|---|---|
designation | String | The designation of the interaction. The designation contains the two trigger groups separated by <> |
type | InteractionType | Type of interaction |
warnings | Warning[] | List of warnings |
right | Drug | Drug responsible for the interaction |
left | Drug | Other drug responsible for the interaction |
source | Source | Source of interaction |
Drug
Attributes | Type | Description |
---|---|---|
clinicalDrug | CodingWithInn | Coding of the clinical drug |
brandedDrug | CodingWithInn | Coding of the branded drug |
packagedDrug | CodingWithInn | Coding of the packaged drug |
Coding
Attributes | Type | Description |
---|---|---|
code | string | Code of this entity in terminology |
label | string | Label of this entity in terminology |
terminology | string | Terminology identifier |
CodingWithInn
Attributes | Type | Description |
---|---|---|
code | string | Code of this entity in terminology |
label | string | Label of this entity in terminology |
terminology | string | Terminology identifier |
inn | string | Code of the inn identifier |
Warning
Attributes | Type | Description |
---|---|---|
risk | String | Risk of interaction |
guidelines | String[] | What to do |
Source
Attributes | Type | Description |
---|---|---|
url | string | Searchable URL for this source |
author | String | Author 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
Variable | Description |
---|---|
CONCOMITANT_USE_NOT_RECOMMENDED | Concomitant use not recommended |
PRECAUTION | Precaution of use |
TAKE_INTO_ACCOUNT | To take into account |
CONTRA_INDICATION | Contra-indication |
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 codes
Code | Description |
---|---|
200 | OK |
400 | One of the parameters passed in the request is invalid |