VIDAL France

analyzePrescription

2 credits per call

Submit a patient + prescription lines to VIDAL Sécurisation (CE-marked) and receive structured clinical alerts: interactions, contraindications, posology, allergy, pregnancy, physico-chemical, redundancy, food, surveillance, side-effects, regulatory. Resolve inputs with searchDrugs, searchPatientTerms, and calculateRenalFunction.

Try it

Open in playground
kirha tools run vidal_analyzePrescription \
  --input '{
    "prescriptionLines": [
      {
        "drugUri": "<drugUri>"
      }
    ]
  }'

Uses the key saved by kirha auth login.

  • prescriptionLinesobject[], required, At least 1 item
    Show 13 fields
    • drugUristring, required

      vidal://product|package|ucd|vmp|prescribable/<id>

    • aldCodestring
    • aldWithinScopeboolean
    • dosenumber, Above 0
    • durationTypestring

      One of MINUTE, HOUR, DAY, WEEK, MONTH, YEAR

    • durationValueinteger, Max 9007199254740991, Above 0
    • endDatestring
    • frequencyTypestring

      One of THIS_DAY, PER_DAY, PER_24_HOURS

    • indicationUrisstring[]
    • routeUristring

      vidal://route/<id>

    • startDatestring
    • statusstring

      One of ACTIVE, COMPLETED

    • unitIdinteger, -9007199254740991 to 9007199254740991
  • alertTypesstring[]

    Restrict returned alert types. If omitted, defaults to actionable safety classes (contraindication, interaction, allergy, posology, precaution, warning, surveillance, food, etc.) — SIDE_EFFECT and EXONERATION are excluded by default because they typically add 100+ informational entries. Pass SIDE_EFFECT explicitly to retrieve them.

    One of CONTRA_INDICATION, DRUG_INTERACTION, ALLERGY, POSOLOGY, PRECAUTION, PHYSICO_CHEMICAL_INTERACTION, REDUNDANT_ACTIVE_INGREDIENT, SAME_DRUG, WARNING, SURVEILLANCE, SIDE_EFFECT, FOOD_INTERACTION, DISPENSING_RISK, EXONERATION, INDICATOR, PRESCRIPTION_CONTEXT, FOCUS, HAS

  • patientobject, default {}
    Show 10 fields
    • allergyUrisstring[], default []
    • breastFeedingStartDatestring

      YYYY-MM-DD

    • creatinineClearanceMlMinnumber, 1 to 300
    • dateOfBirthstring

      YYYY-MM-DD

    • genderstring

      One of MALE, FEMALE, UNKNOWN

    • heightCmnumber, 30 to 250
    • hepaticInsufficiencystring

      One of NONE, MODERATE, SEVERE

    • pathologyUrisstring[], default []
    • weeksOfAmenorrheanumber, 0 to 60
    • weightKgnumber, 0.1 to 300