CPIC Get Recommendations

Overview

Get drug dosing recommendations from a CPIC pharmacogenomic guideline. Returns clinically actionable recommendations linking genotype/phenotype to prescribing actions (classification strength, recommendation text, allele status). Accepts drug name (e.g. 'codeine', 'abacavir') for auto-resolution to guideline_id, or provide guideline_id directly. Key guideline IDs: 100421 (HLA-B/abacavir), 100416 (CYP2D6,OPRM1,COMT/opioids-codeine), 100414 (CYP2D6,CYP2C19/tricyclic-antidepressants), 100415 (CYP2D6/tamoxifen), 100412 (CYP2C9,HLA-B/phenytoin). Note: warfarin (guideline 100425) uses a dosing calculator and returns 0 rows from this endpoint.

Status

The most recent probe succeeded. Safe to call from the agent today.

Last probed

1d ago

Last success

1d ago

Last latency

109ms

Schema

JSON Schema the agent (or your API call) must match.

{
  "properties": {
    "drug": {
      "description": "Drug name to auto-resolve guideline_id (e.g., 'codeine', 'abacavir', 'tamoxifen').",
      "type": "string"
    },
    "drug_name": {
      "description": "Alias for drug.",
      "type": "string"
    },
    "guideline_id": {
      "description": "CPIC guideline numeric ID. Alternative to drug/drug_name. Use CPIC_list_guidelines to browse IDs.",
      "type": "integer"
    },
    "limit": {
      "description": "Maximum number of recommendations to return (default 50)",
      "type": [
        "integer",
        "null"
      ]
    },
    "offset": {
      "description": "Number of recommendations to skip for pagination (default 0)",
      "type": [
        "integer",
        "null"
      ]
    }
  },
  "required": [],
  "type": "object"
}

Examples (1)

{
  "guideline_id": 1
}

Identifiers

Catalog ID

tu_CPIC_get_recommendations

Tool name

CPIC_get_recommendations

Added

2026-04-30 22:47Z

Tags

tooluniverse