Skip to main content
This API reference documents the development Catalog API at https://catalog-api-dev.demo.igvf.org/api. The base URL will change when production is published; see openapi/config.json in the repository.

​
IGVF Catalog REST API

The IGVF Catalog exposes an OpenAPI-compliant REST API for querying the genomics knowledge graph: variants, genes, proteins, regulatory elements, QTLs, pathways, drugs, and more.

​
Base URL

Interactive Swagger UI: catalog-api-dev.demo.igvf.org

​
Pagination

  • page — 0-based page index (default 0)
  • limit — page size; maximum 500 on most endpoints
Example: GET /variants?region=chr1:1157520-1158189&page=0

​
Coordinates

The database uses 0-based, half-open genomic coordinates on GRCh38 (human) and GRCm39 (mouse).

​
Query patterns

Most endpoints accept one primary filter plus optional refinements. Examples in each endpoint description are tested individually (see audit results).

​
Variant identifiers

Variants can be queried by any of:

​
Dataset provenance (files_fileset)

Many edges are tagged with a files_fileset accession (e.g. IGVFFI9602ILPC, ENCFF968BZL) linking Catalog results to source files on the IGVF Portal or ENCODE Portal. See Data Sources and Field lineage for file metadata and column-to-API field mappings.