> ## Documentation Index
> Fetch the complete documentation index at: https://docs.catalog.igvf.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Drugs Variants

> Retrieve variants associated with the query drugs from pharmGKB.

Set verbose = true to retrieve full info on the variants.

Either drug_id or drug_name is required.

Example: drug_id = PA448497,

drug_name = aspirin,

pmid = 20824505,

phenotype_categories = Toxicity.

The limit parameter controls the page size and can not exceed 100.

Pagination is 0-based.



## OpenAPI

````yaml /openapi/catalog-dev.openapi.json get /drugs/variants
openapi: 3.0.3
info:
  title: IGVF Catalog - Development
  description: >-
    Development IGVF Catalog OpenAPI compliant REST API built using tRPC with
    Express.


    Our database uses 0-based, half-open coordinates for genomic coordinates in
    the GRCh38 (human) and GRCm39 (mouse) reference genomes.


    Data is licensed under the Creative Commons license and the software is
    licensed under the MIT license.
  version: 1.2.0 - DEV
servers:
  - url: https://catalog-api-dev.demo.igvf.org/api
security: []
externalDocs:
  url: https://api-dev.catalog.igvf.org/openapi
paths:
  /drugs/variants:
    get:
      summary: Drugs Variants
      description: |-
        Retrieve variants associated with the query drugs from pharmGKB.

        Set verbose = true to retrieve full info on the variants.

        Either drug_id or drug_name is required.

        Example: drug_id = PA448497,

        drug_name = aspirin,

        pmid = 20824505,

        phenotype_categories = Toxicity.

        The limit parameter controls the page size and can not exceed 100.

        Pagination is 0-based.
      operationId: variantsFromDrugs
      parameters:
        - name: drug_id
          in: query
          required: false
          schema:
            type: string
        - name: drug_name
          in: query
          required: false
          schema:
            type: string
        - name: phenotype_categories
          in: query
          required: false
          schema:
            type: string
            enum:
              - Dosage
              - Efficacy
              - Metabolism/PK
              - Other
              - PD
              - Toxicity
        - name: pmid
          in: query
          required: false
          schema:
            type: string
        - name: organism
          in: query
          required: false
          schema:
            type: string
            enum:
              - Homo sapiens
            default: Homo sapiens
        - name: verbose
          in: query
          required: false
          schema:
            type: string
            enum:
              - 'true'
              - 'false'
            default: 'false'
        - name: page
          in: query
          required: false
          schema:
            type: number
            default: 0
        - name: limit
          in: query
          required: false
          schema:
            type: number
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                type: array
                items:
                  type: object
                  properties:
                    sequence_variant:
                      anyOf:
                        - type: string
                        - type: object
                          properties:
                            _id:
                              type: string
                            chr:
                              type: string
                            pos:
                              type: number
                            rsid:
                              type: array
                              items:
                                type: string
                              nullable: true
                            ref:
                              type: string
                            alt:
                              type: string
                            spdi:
                              type: string
                            hgvs:
                              type: string
                            ca_id:
                              type: string
                              nullable: true
                            strain:
                              type: array
                              items:
                                type: string
                              nullable: true
                            qual:
                              type: string
                              nullable: true
                            files_filesets:
                              type: string
                              nullable: true
                            annotations:
                              type: object
                              properties:
                                bravo_af:
                                  type: number
                                  nullable: true
                                gnomad_af_total:
                                  type: number
                                  nullable: true
                                gnomad_af_afr:
                                  type: number
                                  nullable: true
                                gnomad_af_afr_female:
                                  type: number
                                  nullable: true
                                gnomad_af_afr_male:
                                  type: number
                                  nullable: true
                                gnomad_af_ami:
                                  type: number
                                  nullable: true
                                gnomad_af_ami_female:
                                  type: number
                                  nullable: true
                                gnomad_af_ami_male:
                                  type: number
                                  nullable: true
                                gnomad_af_amr:
                                  type: number
                                  nullable: true
                                gnomad_af_amr_female:
                                  type: number
                                  nullable: true
                                gnomad_af_amr_male:
                                  type: number
                                  nullable: true
                                gnomad_af_asj:
                                  type: number
                                  nullable: true
                                gnomad_af_asj_female:
                                  type: number
                                  nullable: true
                                gnomad_af_asj_male:
                                  type: number
                                  nullable: true
                                gnomad_af_eas:
                                  type: number
                                  nullable: true
                                gnomad_af_eas_female:
                                  type: number
                                  nullable: true
                                gnomad_af_eas_male:
                                  type: number
                                  nullable: true
                                gnomad_af_female:
                                  type: number
                                  nullable: true
                                gnomad_af_fin:
                                  type: number
                                  nullable: true
                                gnomad_af_fin_female:
                                  type: number
                                  nullable: true
                                gnomad_af_fin_male:
                                  type: number
                                  nullable: true
                                gnomad_af_male:
                                  type: number
                                  nullable: true
                                gnomad_af_nfe:
                                  type: number
                                  nullable: true
                                gnomad_af_nfe_female:
                                  type: number
                                  nullable: true
                                gnomad_af_nfe_male:
                                  type: number
                                  nullable: true
                                gnomad_af_oth:
                                  type: number
                                  nullable: true
                                gnomad_af_oth_female:
                                  type: number
                                  nullable: true
                                gnomad_af_oth_male:
                                  type: number
                                  nullable: true
                                gnomad_af_sas:
                                  type: number
                                  nullable: true
                                gnomad_af_sas_male:
                                  type: number
                                  nullable: true
                                gnomad_af_sas_female:
                                  type: number
                                  nullable: true
                                gnomad_af_raw:
                                  type: number
                                  nullable: true
                                GENCODE_category:
                                  type: string
                                  nullable: true
                                funseq_description:
                                  type: string
                                  nullable: true
                              additionalProperties: false
                              nullable: true
                            source:
                              type: string
                            source_url:
                              type: string
                            organism:
                              type: string
                              nullable: true
                          required:
                            - _id
                            - chr
                            - pos
                            - ref
                            - alt
                            - annotations
                            - source
                            - source_url
                            - organism
                          additionalProperties: false
                    _to:
                      type: string
                    gene_symbol:
                      type: array
                      items:
                        type: string
                    pmid:
                      type: string
                    study_parameters:
                      type: array
                      items:
                        type: object
                        properties:
                          study_parameter_id:
                            type: string
                          study_type:
                            type: string
                          study_cases:
                            type: string
                          study_controls:
                            type: string
                          p-value:
                            type: string
                          biogeographical_groups:
                            type: string
                        required:
                          - study_parameter_id
                        additionalProperties: false
                    phenotype_categories:
                      type: array
                      items:
                        type: string
                    source:
                      type: string
                    source_url:
                      type: string
                    name:
                      type: string
                  required:
                    - _to
                    - source
                    - source_url
                    - name
                  additionalProperties: false
        default:
          $ref: '#/components/responses/error'
components:
  responses:
    error:
      description: Error response
      content:
        application/json:
          schema:
            type: object
            properties:
              message:
                type: string
              code:
                type: string
              issues:
                type: array
                items:
                  type: object
                  properties:
                    message:
                      type: string
                  required:
                    - message
                  additionalProperties: false
            required:
              - message
              - code
            additionalProperties: false

````