Cortexa research tool·drug discovery·pharmgkb

PharmGKB Get Clinical Annotations

Get clinical annotations showing gene-drug-phenotype relationships. Returns variant-level clinical significance data. Always provide annotation_id — gene_id lookup is not supported by the API and returns an error with guidance.

Livelast probed 2026-04-30 23:07Z· 93msCortexa

Status

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

Last probed: 1d ago
Last success: 1d ago
Last latency: 93ms

Schema

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

{
  "properties": {
    "annotation_id": {
      "description": "PharmGKB clinical annotation ID (e.g., '1447954390'). Required for reliable results.",
      "type": "string"
    },
    "gene": {
      "description": "NOT SUPPORTED: PharmGKB API requires a specific annotation_id (e.g. \"1447954390\"), not a gene symbol. Browse https://www.pharmgkb.org/clinicalAnnotation to find annotation IDs. For gene-drug dosing use CPIC_list_guidelines instead.",
      "type": "string"
    },
    "gene_id": {
      "description": "PharmGKB Gene Accession ID (e.g., \"PA128\"). NOTE: Gene-based lookup is not supported — will return an error with instructions to use annotation_id instead.",
      "type": "string"
    },
    "gene_symbol": {
      "description": "Alias for gene — NOT SUPPORTED. See gene parameter.",
      "type": "string"
    }
  },
  "required": [],
  "type": "object"
}

Examples (1)

Default PharmGKB Get Clinical Annotations call

public-safeinput

{
  "gene": "BRCA1",
  "gene_id": "BRCA1",
  "gene_symbol": "BRCA1"
}

Expected response keys: success

Anonymous-safe example. Rate-limited; no sign-in required.

Identifiers

Catalog ID: tu_PharmGKB_get_clinical_annotations
Tool name: PharmGKB_get_clinical_annotations
Added: 2026-04-30 22:47Z
Tags: tooluniverse

Schema

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

{ "properties": { "annotation_id": { "description": "PharmGKB clinical annotation ID (e.g., '1447954390'). Required for reliable results.", "type": "string" }, "gene": { "description": "NOT SUPPORTED: PharmGKB API requires a specific annotation_id (e.g. \"1447954390\"), not a gene symbol. Browse https://www.pharmgkb.org/clinicalAnnotation to find annotation IDs. For gene-drug dosing use CPIC_list_guidelines instead.", "type": "string" }, "gene_id": { "description": "PharmGKB Gene Accession ID (e.g., \"PA128\"). NOTE: Gene-based lookup is not supported — will return an error with instructions to use annotation_id instead.", "type": "string" }, "gene_symbol": { "description": "Alias for gene — NOT SUPPORTED. See gene parameter.", "type": "string" } }, "required": [], "type": "object" }