---
title: "Drug–gene pairs for a pharmacogene"
method: GET
path: "/pgx/{gene}"
tags: ["knowledge"]
---

# Drug–gene pairs for a pharmacogene

`GET /pgx/{gene}`

## Request

- Base URL: `https://deepdna.ai/api/v1`
- URL: `https://deepdna.ai/api/v1/pgx/{gene}`
- Auth: none declared

## Path parameters

- `gene` string, required

## Response `200`

Pairs

- object
  - `gene` string
  - `count` integer
  - `pairs` PgxPair[]
    - `gene` string, required
    - `drug` string, required
    - `guideline` string, nullable: CPIC, DPWG or null
    - `level` string, nullable: Guideline evidence level when the source states it; null otherwise
    - `summary` string, nullable
    - `sources` Source[]
      - `label` string, required
      - `url` string, uri, nullable: null for a literature citation given by author/journal/year
    - `phenotypes` string[]: Phenotype groups the guideline distinguishes for this pair
  - `meta` Meta
    - `disclaimer` string
    - `api_version` string
    - `docs` string, uri
    - `status` string

## Other responses

- `404`: Not in the knowledge base

---

[API](https://skmtc.dev/deepdna/apis/deepdna-api.md) · [All operations](https://skmtc.dev/deepdna/apis/deepdna-api/llms.txt) · [OpenAPI document](https://skmtc.dev/deepdna/apis/deepdna-api/revisions/e33e002594ea?raw)