# Open Targets API
> Drug target–disease associations as an API, powered by the Open Targets Platform. Open Targets integrates human genetics, genomics, transcriptomics, known drugs, animal models and the scientific literature to systematically score how strongly a target (gene/protein) is associated with a disease — the evidence that underpins modern drug discovery. Search across targets, diseases and drugs; read a target for its approved symbol, biotype, function, genomic location and UniProt ids together with the diseases it is most strongly associated with and their overall association scores; read a disease for its description, therapeutic areas and its top associated targets with scores; and read a drug for its modality, maximum clinical stage, trade names, synonyms and mechanisms of action. Ideal for drug-discovery and target-identification pipelines, therapeutic-area research, biomedical data science and pharma intelligence tools. Target ids are Ensembl gene ids, disease ids are EFO/MONDO/Orphanet ids, drug ids are ChEMBL ids. Data is open (CC0).

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/opentargets-api/..."
```

## Pricing
- **Free** (Free) — 520 calls/Mo, 2 req/s
- **Starter** ($7/Mo) — 19,200 calls/Mo, 6 req/s
- **Pro** ($22/Mo) — 87,800 calls/Mo, 15 req/s
- **Mega** ($61/Mo) — 336,000 calls/Mo, 40 req/s

## Endpoints

### Search

#### `GET /v1/search` — Search targets, diseases & drugs

**Parameters:**
- `query` (query, required, string) — Search text, e.g. BRCA1 Example: `BRCA1`
- `type` (query, optional, string) — target|disease|drug

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/opentargets-api/v1/search?query=BRCA1"
```

**Response:**
```json
{
    "data": {
        "count": 25,
        "query": "BRCA1",
        "results": [
            {
                "id": "ENSG00000012048",
                "name": "BRCA1",
                "entity": "target",
                "description": "BRCA1 DNA repair associated"
            },
            {
                "id": "MONDO_0700268",
                "name": "BRCA1-related cancer predisposition",
                "entity": "disease",
                "description": "Hereditary cancer predisposition due to variation(s) in the BRCA1 gene. Germline pathogenic or likely pathogenic variants in the BRCA1 gene confer an autosomal dominant predisposition to hereditary br"
            },
            {
                "id": "MONDO_0013685",
                "name": "pancreatic cancer, susceptibility to, 4",
                "entity": "disease",
                "description": "Any familial pancreatic carcinoma in which the cause of the disease is a mutation in the BRCA1 gene."
            },
            {
                "id": "MONDO_0003582",
                "name": "hereditary breast ovarian cancer syndrome",
                "entity": "disease",
                "description": "An autosomal dominant inherited syndrome caused by mutations in the BRCA1 or BRCA2 genes. Patients are at high risk of developing breast cancer, particularly before the age of fifty, high risk of deve"
            },
            {
                "id": "Orphanet_145",
                "name": "Hereditary breast and o
…(truncated, see openapi.json for full schema)
```

### Targets

#### `GET /v1/target` — A target & its associated diseases

**Parameters:**
- `id` (query, required, string) — Ensembl gene id, e.g. ENSG00000012048 Example: `ENSG00000012048`
- `limit` (query, optional, string) — Max associated diseases (1-50)

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/opentargets-api/v1/target?id=ENSG00000012048"
```

**Response:**
```json
{
    "data": {
        "target": {
            "id": "ENSG00000012048",
            "end": 43170245,
            "name": "BRCA1 DNA repair associated",
            "start": 43044292,
            "symbol": "BRCA1",
            "biotype": "protein_coding",
            "function": "E3 ubiquitin-protein ligase that specifically mediates the formation of 'Lys-6'-linked polyubiquitin chains and plays a central role in DNA repair by facilitating cellular responses to DNA damage (PubMed:10500182, PubMed:12887909, PubMed:12890688, PubMed:14976165, PubMed:16818604, PubMed:17525340, PubMed:19261748). It is unclear whether it also mediates the formation of other types of polyubiquitin chains (PubMed:12890688). The BRCA1-BARD1 heterodimer coordinates a diverse range of cellular pathways such as DNA damage repair, ubiquitination and transcriptional regulation to maintain genomic stability (PubMed:12890688, PubMed:14976165, PubMed:20351172). Regulates centrosomal microtubule nucleation (PubMed:18056443). Required for appropriate cell cycle arrests after ionizing irradiation in b",
            "chromosome": "17",
            "uniprot_ids": [
                "P38398",
                "A0A0U1RRA9",
                "A0A2R8Y6Y9",
                "A0A2R8Y7V5",
                "A0A494C182"
            ],
            "associated_diseases": [
                {
                    "id": "MONDO_0007254",
                    "name": "breast cancer",
                    "score": 0.839
                }
…(truncated, see openapi.json for full schema)
```

### Diseases

#### `GET /v1/disease` — A disease & its associated targets

**Parameters:**
- `id` (query, required, string) — Disease id, e.g. EFO_0000305 Example: `EFO_0000305`
- `limit` (query, optional, string) — Max associated targets (1-50)

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/opentargets-api/v1/disease?id=EFO_0000305"
```

**Response:**
```json
{
    "data": {
        "disease": {
            "id": "EFO_0000305",
            "name": "breast carcinoma",
            "description": "A carcinoma that arises from epithelial cells of the breast",
            "therapeutic_areas": [
                "integumentary system disease",
                "reproductive system or breast disease",
                "cancer or benign tumor"
            ],
            "associated_targets": [
                {
                    "id": "ENSG00000139618",
                    "score": 0.892,
                    "symbol": "BRCA2"
                },
                {
                    "id": "ENSG00000012048",
                    "score": 0.876,
                    "symbol": "BRCA1"
                },
                {
                    "id": "ENSG00000083093",
                    "score": 0.867,
                    "symbol": "PALB2"
                },
                {
                    "id": "ENSG00000141510",
                    "score": 0.861,
                    "symbol": "TP53"
                },
                {
                    "id": "ENSG00000121879",
                    "score": 0.85,
                    "symbol": "PIK3CA"
                },
                {
                    "id": "ENSG00000183765",
                    "score": 0.84,
                    "symbol": "CHEK2"
                },
                {
                    "id": "ENSG00000149311",
                    "score": 0.835,
                    "symbol": "ATM"
…(truncated, see openapi.json for full schema)
```

### Drugs

#### `GET /v1/drug` — A drug & its mechanisms of action

**Parameters:**
- `id` (query, required, string) — ChEMBL id, e.g. CHEMBL1201583 Example: `CHEMBL1201583`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/opentargets-api/v1/drug?id=CHEMBL1201583"
```

**Response:**
```json
{
    "data": {
        "drug": {
            "id": "CHEMBL1201583",
            "name": "BEVACIZUMAB",
            "type": "Antibody",
            "synonyms": [
                "12-IGG1",
                "AVA-1",
                "Abp-215",
                "Alymsys",
                "Avzivi",
                "BAT-1706",
                "BEVZ-92",
                "BEVZ92",
                "BI 695502",
                "BI695502"
            ],
            "description": "Antibody drug with a maximum clinical stage of Approval (across all indications), with 20 approved and 146 investigational indications.",
            "trade_names": [
                "Abevmy",
                "Alymsys",
                "Avastin",
                "Avzivi",
                "Aybintio",
                "Equidacent",
                "Lextemy",
                "Mvasi",
                "Onbevzi",
                "Oyavas"
            ],
            "indication_count": 166,
            "max_clinical_stage": "APPROVAL",
            "mechanisms_of_action": [
                {
                    "target": "Vascular endothelial growth factor A, long form",
                    "mechanism": "Vascular endothelial growth factor A inhibitor",
                    "action_type": "INHIBITOR"
                }
            ]
        }
    },
    "meta": {
        "timestamp": "2026-06-01T08:13:36.398Z",
        "request_id": "3e673637-cd2f-4201-a841-6a917e469e9e"
    },
    "status": "ok",
    "message": "Drug retri
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Usage notes

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/opentargets-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "note": "Drug target–disease associations. Open Targets integrates genetics, genomics, expression, known drugs and literature to score how strongly a target (gene) is associated with a disease. /v1/search?query=BRCA1 (filter type=target|disease|drug) = search across targets, diseases & drugs; /v1/target?id=ENSG00000012048 = a target's symbol, biotype, function, location and its top associated diseases with overall scores (paginate with limit); /v1/disease?id=EFO_0000305 = a disease's description, therapeutic areas and its top associated targets with scores; /v1/drug?id=CHEMBL1201583 = a drug's type, development phase, mechanisms of action, trade names and linked targets/diseases. Target ids are Ensembl gene ids (ENSG…), disease ids are EFO/MONDO/Orphanet ids, drug ids are ChEMBL ids. Data from Open Targets (CC0). For protein sequences see UniProt, for pathways Reactome, for bioactivity ChEMBL.",
        "source": "Open Targets Platform GraphQL API (platform.opentargets.org)",
        "endpoints": [
            "/v1/search",
            "/v1/target",
            "/v1/disease",
            "/v1/drug",
            "/v1/meta"
        ]
    },
    "meta": {
        "timestamp": "2026-06-01T08:13:36.477Z",
        "request_id": "27f02718-3d8a-4ce0-9bdb-a822629c8540"
    },
    "status": "ok",
    "message": "Meta retrieved",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/opentargets-api
OpenAPI spec: https://www.oanor.com/api/opentargets-api/openapi.json