getSubstitutes

2 credits per call

Find alternatives via one of four modes: generic (répertoire ANSM), hybrid (ANSM 2024), biosimilar, or foreign (same ATC, another country).

Try it

Open in playground
kirha tools run vidal_getSubstitutes \
  --input '{
    "drugUri": "<drugUri>",
    "mode": "generic"
  }'

Uses the key saved by kirha auth login.

  • drugUristring, required, Matches ^vidal:\/\/product\/[A-Za-z0-9_-]+$

    From searchDrugs.uris[] (product scope)

  • modestring, required

    One of generic, hybrid, biosimilar, foreign

  • countryCodestring, 2 to 2 characters

    ISO-3166 alpha-2; required when mode=foreign

  • limitnumber, default 25, 1 to 50