Back to catalog
Cortexa research tool·genomics·gwas
Gwas Search Associations
Search the GWAS Catalog for genome-wide association study results by keyword. Accepts free-text disease/trait names (e.g., 'melanoma', 'diabetes', 'breast cancer'), SNP rs IDs, EFO ontology IDs, or study accession IDs. This is the primary tool for discovering GWAS associations when you do NOT already have a specific association ID. Returns SNPs, p-values, odds ratios, mapped genes, and study metadata with pagination support.
Livelast probed 2026-04-30 23:07Z· 92msCortexa
Status
The most recent probe succeeded. Safe to call from the agent today.
- Last probed
- 1d ago
- Last success
- 1d ago
- Last latency
- 92ms
Schema
JSON Schema the agent (or your API call) must match.
{
"properties": {
"accession_id": {
"description": "Study accession identifier",
"type": "string"
},
"direction": {
"description": "Sort direction ('asc' or 'desc')",
"type": "string"
},
"disease_trait": {
"description": "Disease or trait name for text-based search (e.g., 'diabetes', 'coronary artery disease', 'breast cancer'). NOTE: GWAS associations are indexed by trait/disease, not by gene or drug name — passing a gene symbol or drug name here will fail. Use efo_id for precise filtering.",
"type": "string"
},
"efo_id": {
"description": "EFO/OBA term ID (e.g., 'EFO_0001645', 'OBA_2050062'). Recommended for reliable trait filtering.",
"type": "string"
},
"efo_trait": {
"description": "Exact EFO trait label (e.g., 'serum alanine aminotransferase amount'). Use when you know the canonical trait string.",
"type": "string"
},
"efo_uri": {
"description": "Full EFO ontology URI (e.g., 'http://www.ebi.ac.uk/efo/EFO_0001645')",
"type": "string"
},
"p_value": {
"description": "Maximum p-value threshold for filtering (e.g., 5e-8 for genome-wide significance). Applied client-side after retrieval.",
"type": "number"
},
"p_value_threshold": {
"description": "Alias for p_value: maximum p-value threshold.",
"type": "number"
},
"page": {
"description": "Page number for pagination",
"type": "integer"
},
"query": {
"description": "Alias for disease_trait. Disease or trait name (e.g., 'type 2 diabetes'). NOTE: gene symbols and drug names are not valid GWAS trait queries.",
"type": "string"
},
"rs_id": {
"description": "dbSNP rs identifier",
"type": "string"
},
"size": {
"description": "Number of results to return",
"type": "integer"
},
"sort": {
"description": "Sort field (e.g., 'p_value', 'or_value')",
"type": "string"
}
},
"required": [],
"type": "object"
}Examples (1)
Default Gwas Search Associations call
public-safeinput
{
"accession_id": "P38398",
"disease_trait": "type 2 diabetes",
"efo_trait": "type 2 diabetes",
"p_value": 1,
"p_value_threshold": 1,
"page": 1,
"query": "type 2 diabetes",
"size": 1
}Expected response keys: success
Anonymous-safe example. Rate-limited; no sign-in required.
Identifiers
- Catalog ID
- tu_gwas_search_associations
- Tool name
- gwas_search_associations
- Added
- 2026-04-30 22:47Z
- Tags
- tooluniverse