---
name: dante-labs-genome-data
description: Look up genes, variants and HPO traits on dantelabs.com as JSON, and search them by gene symbol, alias, variant name, rsID or genomic position. Use when a task needs a gene's HGNC record and the Dante Labs reports that cover it, a variant's ClinVar classification, or the genes linked to a trait.
---

# Dante Labs genome data

Gene, variant and trait pages and the genome search as JSON: the facts each page shows, every link an absolute `url`. Public and read-only, with no key; any origin may read it.

Each path is also its page's URL without `.json`, asked for with `Accept: application/json`.

These are reference facts about genes, variants and traits, not anyone's results: cite the page's `url`, and don't present a classification as a diagnosis.

OpenAPI: https://dantelabs.com/openapi.json

| Read | URL |
| --- | --- |
| Search | `https://dantelabs.com/genes/search.json?q={q}` |
| A gene | `https://dantelabs.com/genes/{gene}.json` |
| A variant | `https://dantelabs.com/genes/{gene}/variants/{variant}.json` |
| A trait | `https://dantelabs.com/traits/{trait}.json` |

## Search

Genes, variant pages and conditions by any name or ID, and what lies at a place in the genome. Search first unless you already have a page's URL: follow each hit's `url` or `json` rather than building a path. A query not asked before is a live search, so searches are metered per client.

- `q` (query, required): A gene symbol, alias or name, a variant name or rsID, a condition, or a position, range or band.
- `build` (query, optional; one of `GRCh38`, `GRCh37`; default `GRCh38`): The reference genome a place is read on.

```sh
curl -s 'https://dantelabs.com/genes/search.json?q=ABCC7'
```

## A gene

HGNC's record for the gene and its MANE Select transcript, with the reports, medicines and traits naming it and its variant pages. Under a language prefix (`/de/genes/apoe.json`) it answers in that language wherever a translation exists.

- `gene` (path, required): The HGNC symbol, lower-cased.

```sh
curl -s 'https://dantelabs.com/genes/apoe.json'
```

## A variant

ClinVar's record for the variant, its classification under the ACMG/AMP criteria with the evidence for each, and the reports that read it, in English. A retired page still answers, with `status` `retired`, why, and what ClinVar says now.

- `gene` (path, required): The gene's HGNC symbol, lower-cased.
- `variant` (path, required): The variant's slug, as its gene's `variants.items` list it. A ClinVar variation (`vcv7105`) or a GRCh38 change (`7-117559590-atct-a`) also works, answered with a 301 to its page.

```sh
curl -s 'https://dantelabs.com/genes/cftr/variants/f508del.json'
```

## A trait

A Human Phenotype Ontology term, its broader and narrower terms and the genes linked to it, in English under every language prefix. HPO's licence asks that you name its `release` wherever you use the data.

- `trait` (path, required): The trait's slug.

```sh
curl -s 'https://dantelabs.com/traits/seizure.json'
```

## Errors

`{ "error": "..." }` with the status; on a 429 or 503, wait `Retry-After` seconds.

- **400:** No `q`.
- **429:** Too many searches from this client.
- **503:** The genome data is unavailable for now.
- **301:** A capitalised or former slug: `Location` is the current `.json` URL.
- **404:** No such page.