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

# Genes Genes

> Retrieve coexpressed gene pairs from CoXPresdb and genetic interactions from BioGRID.

The following parameters can be used to set thresholds on z_score from CoXPresdb: gt (>), gte (>=), lt (\<), lte (\<=).

At least one of these fields is required: gene_id, hgnc_id, gene_name, alias.

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

Pagination is 0-based.

**Examples by source**

These examples are grouped by source; use the `source` filter to return data from a specific source.

**BioGRID:**

**Single result**

- gene_id = ENSG00000112592
- associated_gene_id = ENSG00000163132
- source = BioGRID

**Group results**

- gene_id = ENSG00000112592
- source = BioGRID

**COXPRESdb:**

**Single result**

- gene_id = ENSG00000153048
- associated_gene_id = ENSG00000233369
- source = COXPRESdb

**Group results**

- gene_id = ENSG00000153048
- source = COXPRESdb



## OpenAPI

````yaml /openapi/catalog-dev.openapi.json get /genes/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:
  /genes/genes:
    get:
      summary: Genes Genes
      description: >-
        Retrieve coexpressed gene pairs from CoXPresdb and genetic interactions
        from BioGRID.


        The following parameters can be used to set thresholds on z_score from
        CoXPresdb: gt (>), gte (>=), lt (\<), lte (\<=).


        At least one of these fields is required: gene_id, hgnc_id, gene_name,
        alias.


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


        Pagination is 0-based.


        **Examples by source**


        These examples are grouped by source; use the `source` filter to return
        data from a specific source.


        **BioGRID:**


        **Single result**


        - gene_id = ENSG00000112592

        - associated_gene_id = ENSG00000163132

        - source = BioGRID


        **Group results**


        - gene_id = ENSG00000112592

        - source = BioGRID


        **COXPRESdb:**


        **Single result**


        - gene_id = ENSG00000153048

        - associated_gene_id = ENSG00000233369

        - source = COXPRESdb


        **Group results**


        - gene_id = ENSG00000153048

        - source = COXPRESdb
      operationId: genesGenes
      parameters:
        - name: gene_id
          in: query
          required: false
          schema:
            type: string
        - name: hgnc_id
          in: query
          required: false
          schema:
            type: string
        - name: gene_name
          in: query
          required: false
          schema:
            type: string
        - name: alias
          in: query
          required: false
          schema:
            type: string
        - name: associated_gene_id
          in: query
          required: false
          schema:
            type: string
        - name: associated_hgnc_id
          in: query
          required: false
          schema:
            type: string
        - name: associated_gene_name
          in: query
          required: false
          schema:
            type: string
        - name: associated_alias
          in: query
          required: false
          schema:
            type: string
        - name: z_score
          in: query
          required: false
          schema:
            type: string
        - name: interaction_type
          in: query
          required: false
          schema:
            type: string
            enum:
              - dosage growth defect (sensu BioGRID)
              - dosage lethality (sensu BioGRID)
              - dosage rescue (sensu BioGRID)
              - negative genetic interaction (sensu BioGRID)
              - phenotypic enhancement (sensu BioGRID)
              - phenotypic suppression (sensu BioGRID)
              - positive genetic interaction (sensu BioGRID)
              - synthetic growth defect (sensu BioGRID)
              - synthetic lethality (sensu BioGRID)
              - synthetic rescue (sensu BioGRID)
        - name: label
          in: query
          required: false
          schema:
            type: string
            enum:
              - co-expression
              - genetic interference
        - name: method
          in: query
          required: false
          schema:
            type: string
            enum:
              - COXPRESdb
              - dosage growth defect (sensu BioGRID)
              - dosage lethality (sensu BioGRID)
              - >-
                dosage lethality (sensu BioGRID), phenotypic enhancement (sensu
                BioGRID)
              - >-
                dosage lethality (sensu BioGRID), synthetic lethality (sensu
                BioGRID)
              - dosage rescue (sensu BioGRID)
              - >-
                dosage rescue (sensu BioGRID), phenotypic enhancement (sensu
                BioGRID)
              - >-
                dosage rescue (sensu BioGRID), synthetic growth defect (sensu
                BioGRID)
              - negative genetic interaction (sensu BioGRID)
              - >-
                negative genetic interaction (sensu BioGRID), synthetic growth
                defect (sensu BioGRID)
              - >-
                negative genetic interaction (sensu BioGRID), synthetic
                lethality (sensu BioGRID)
              - >-
                negative genetic interaction (sensu BioGRID), synthetic
                lethality (sensu BioGRID), synthetic growth defect (sensu
                BioGRID)
              - phenotypic enhancement (sensu BioGRID)
              - >-
                phenotypic enhancement (sensu BioGRID), phenotypic suppression
                (sensu BioGRID)
              - >-
                phenotypic enhancement (sensu BioGRID), synthetic growth defect
                (sensu BioGRID)
              - >-
                phenotypic enhancement (sensu BioGRID), synthetic lethality
                (sensu BioGRID)
              - phenotypic suppression (sensu BioGRID)
              - >-
                phenotypic suppression (sensu BioGRID), negative genetic
                interaction (sensu BioGRID)
              - >-
                phenotypic suppression (sensu BioGRID), phenotypic enhancement
                (sensu BioGRID)
              - positive genetic interaction (sensu BioGRID)
              - >-
                positive genetic interaction (sensu BioGRID), negative genetic
                interaction (sensu BioGRID)
              - >-
                positive genetic interaction (sensu BioGRID), phenotypic
                enhancement (sensu BioGRID)
              - >-
                positive genetic interaction (sensu BioGRID), synthetic
                lethality (sensu BioGRID)
              - >-
                positive genetic interaction (sensu BioGRID), synthetic rescue
                (sensu BioGRID)
              - synthetic growth defect (sensu BioGRID)
              - >-
                synthetic growth defect (sensu BioGRID), phenotypic enhancement
                (sensu BioGRID)
              - synthetic haploinsufficiency (sensu BioGRID)
              - >-
                synthetic haploinsufficiency (sensu BioGRID), dosage rescue
                (sensu BioGRID)
              - >-
                synthetic haploinsufficiency (sensu BioGRID), phenotypic
                enhancement (sensu BioGRID), phenotypic suppression (sensu
                BioGRID)
              - synthetic lethality (sensu BioGRID)
              - >-
                synthetic lethality (sensu BioGRID), phenotypic enhancement
                (sensu BioGRID), phenotypic suppression (sensu BioGRID)
              - >-
                synthetic lethality (sensu BioGRID), synthetic growth defect
                (sensu BioGRID)
              - synthetic rescue (sensu BioGRID)
        - name: source
          in: query
          required: false
          schema:
            type: string
            enum:
              - BioGRID
              - COXPRESdb
        - name: name
          in: query
          required: false
          schema:
            type: string
            enum:
              - coexpressed with
              - interacts with
        - name: organism
          in: query
          required: false
          schema:
            type: string
            enum:
              - Mus musculus
              - 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:
                    _id:
                      type: string
                    gene_1:
                      anyOf:
                        - type: string
                        - type: array
                          items:
                            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
                            required:
                              - _id
                              - chr
                              - start
                              - end
                              - gene_type
                              - name
                              - source
                              - version
                              - source_url
                            additionalProperties: false
                    gene_2:
                      anyOf:
                        - type: string
                        - type: array
                          items:
                            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
                            required:
                              - _id
                              - chr
                              - start
                              - end
                              - gene_type
                              - name
                              - source
                              - version
                              - source_url
                            additionalProperties: false
                    z_score:
                      type: number
                    detection_method:
                      type: string
                    detection_method_code:
                      type: string
                    interaction_type:
                      type: array
                      items:
                        type: string
                    interaction_type_code:
                      type: array
                      items:
                        type: string
                    confidence_value_biogrid:
                      type: number
                      nullable: true
                    confidence_value_intact:
                      type: number
                      nullable: true
                    pmids:
                      type: array
                      items:
                        type: string
                    label:
                      type: string
                    method:
                      type: string
                    class:
                      type: string
                    source:
                      type: string
                    source_url:
                      type: string
                    name:
                      type: string
                  required:
                    - _id
                    - gene_1
                    - gene_2
                    - label
                    - method
                    - class
                    - source
                    - 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

````