> ## 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.

# Diseases Genes

> Retrieve disease-gene pairs from Orphanet and GenCC by diseases.

Set verbose = true to retrieve full info on the genes and diseases.

Example: disease_name = fibrosis,

disease_id = Orphanet_586,

source = Orphanet.

Either disease_name or disease_id are required.

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

Pagination is 0-based.



## OpenAPI

````yaml /openapi/catalog-dev.openapi.json get /diseases/genes
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:
  /diseases/genes:
    get:
      summary: Diseases Genes
      description: |-
        Retrieve disease-gene pairs from Orphanet and GenCC by diseases.

        Set verbose = true to retrieve full info on the genes and diseases.

        Example: disease_name = fibrosis,

        disease_id = Orphanet_586,

        source = Orphanet.

        Either disease_name or disease_id are required.

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

        Pagination is 0-based.
      operationId: genesFromDiseases
      parameters:
        - name: disease_id
          in: query
          required: false
          schema:
            type: string
        - name: disease_name
          in: query
          required: false
          schema:
            type: string
        - name: source
          in: query
          required: false
          schema:
            type: string
            enum:
              - GenCC
              - Orphanet
        - 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:
                    pmids:
                      type: array
                      items:
                        type: string
                      nullable: true
                    term_name:
                      type: string
                    gene_symbol:
                      type: string
                    association_type:
                      type: string
                      nullable: true
                    association_status:
                      type: string
                      nullable: true
                    sgc_id:
                      type: string
                      nullable: true
                    hgnc:
                      type: string
                      nullable: true
                    classification:
                      type: string
                      nullable: true
                    moi_id:
                      type: string
                      nullable: true
                    moi_name:
                      type: string
                      nullable: true
                    submitter:
                      type: string
                      nullable: true
                    source:
                      type: string
                    source_url:
                      type: string
                    gene:
                      anyOf:
                        - type: string
                        - type: object
                          properties:
                            _id:
                              type: string
                            chr:
                              type: string
                            start:
                              type: number
                              nullable: true
                            end:
                              type: number
                              nullable: true
                            gene_type:
                              type: string
                              nullable: true
                            name:
                              type: string
                            strand:
                              type: string
                              nullable: true
                            hgnc:
                              type: string
                              nullable: true
                            entrez:
                              type: string
                              nullable: true
                            collections:
                              type: array
                              items:
                                type: string
                              nullable: true
                            study_sets:
                              type: array
                              items:
                                type: string
                              nullable: true
                            source:
                              type: string
                            version:
                              type: string
                            source_url:
                              type: string
                            synonyms:
                              type: array
                              items:
                                type: string
                              nullable: true
                          required:
                            - _id
                            - chr
                            - start
                            - end
                            - gene_type
                            - name
                            - source
                            - version
                            - source_url
                          additionalProperties: false
                    disease:
                      anyOf:
                        - type: string
                        - type: object
                          properties:
                            uri:
                              type: string
                            term_id:
                              type: string
                            name:
                              type: string
                            synonyms:
                              type: array
                              items:
                                type: string
                              nullable: true
                            description:
                              type: string
                              nullable: true
                            source:
                              type: string
                            subontology:
                              type: string
                              nullable: true
                            source_url:
                              type: string
                              nullable: true
                          required:
                            - uri
                            - term_id
                            - name
                          additionalProperties: false
                    inheritance_mode:
                      type: string
                      nullable: true
                    variants:
                      type: array
                      items:
                        type: object
                        properties:
                          chr:
                            type: string
                          pos:
                            type: number
                          ref:
                            type: string
                          alt:
                            type: string
                          rsid:
                            type: array
                            items:
                              type: string
                            nullable: true
                          spdi:
                            type: string
                          hgvs:
                            type: string
                        required:
                          - chr
                          - pos
                          - ref
                          - alt
                        additionalProperties: false
                    name:
                      type: string
                  required:
                    - 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

````