# Open Targets Platform · List associations

Get health and medical data with Open Targets Platform · List associations from Alexandria through one Spiral API key. Rank diseases linked to a gene, rank targets for a disease (e.g. genetically supported targets for asthma), or check how strongly and by what evidence one target is linked to one disease. Follow with `list_evidence` for the underlying records. It runs in the background and returns structured JSON. Pay as you go, with no subscription.

- Provider: Alexandria
- Category: Health
- Runs: In the background
- Returns: json
- Tool id: `alexandria` / `platform-opentargets-org/associations/list_associations`
- Page: https://spiral.ai/tools/alexandria/platform-opentargets-org/associations/list_associations

## Pricing

$0.00873 per call.

## Limits

- Longest queue wait: 1 hour
- Run deadline: 5 minutes
- Longest run, end to end: 225 minutes
- Largest inline input: 1 MB
- Largest input file: 2 GB
- Largest output: 5 GB

## Input

| Field | Kind | Allowed | Default | Description |
| --- | --- | --- | --- | --- |
| `limit` | number | 1 to 100 | 25 | Rows per page, 1 to 100. |
| `cursor` | text |  | — | `next_cursor` from the previous page. Repeat the same inputs and `limit` with it. Pattern: ^[0-9]+$. |
| `target` | text |  | — | Target: an HGNC symbol (`BRAF`), Ensembl gene ID (`ENSG00000157764`), UniProt accession (`P15056`), previous symbol, synonym (`HER2`, `p53`), approved name, or a platform.opentargets.org target page URL. Ambiguous synonyms fail as invalid_input naming the candidates. |
| `disease` | text |  | — | Disease or phenotype: an ontology ID (`MONDO_0004979`, `EFO_0000270`, `EFO:0000270`, `HP_0002099`, `Orphanet_558`), an exact name or exact synonym (`asthma`, `T2DM`), or a platform.opentargets.org disease page URL. Retired EFO IDs follow to their replacement with a `disease_replaced` warning; other names fail as not_found listing the closest matches (use `search_diseases` to browse). |
| `indirect` | true or false |  | — | Include indirect evidence, which propagates evidence on a disease's descendants up to it (e.g. Crohn's disease evidence counts for inflammatory bowel disease). Defaults to false for a target's diseases and true when a disease is given, as on the Open Targets pages. |
| `order_by` | one of | score, genetic_association, genetic_literature, somatic_mutation, clinical, affected_pathway, rna_expression, literature, animal_model | score | Rank by the overall score or by one evidence type's score, descending. |
| `min_score` | number | 0 to 1 | — | Stop at rows whose ranking score (overall, or the `order_by` evidence type) is below this. |
| `therapeutic_area` | text |  | — | Only a target's diseases in this therapeutic area: a name or words of it (`cancer`, `respiratory`, `immune system disorder`) or its ID (`MONDO_0045024`). Not with `disease`. |

## Example

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "platform-opentargets-org/associations/list_associations",
    "input": {
      "limit": 25
    }
  }'
```

Try it in the Playground: https://spiral.ai/start?provider=alexandria&model=platform-opentargets-org%2Fassociations%2Flist_associations

## Common questions

### Open Targets Platform · List associations

**How much does Open Targets Platform · List associations cost?**

$0.00873 per call. You pay as you go from one Spiral balance, with no subscription, and a failed run is not charged.

**How do I use Open Targets Platform · List associations through an API?**

Send `POST /v1/runs` with `"provider": "alexandria"`, `"model": "platform-opentargets-org/associations/list_associations"` and the input fields on this page, using one Spiral API key. It runs in the background: poll the run, or name a webhook to be told when it finishes.

**Do I need an account with Alexandria to use Open Targets Platform · List associations?**

No. Spiral runs it on its own Alexandria account and charges your Spiral balance.

**Can my AI agent use Open Targets Platform · List associations?**

Yes. Agents find and run it through Spiral's MCP server, CLI or agent skill, with the same API key.

