{"openapi":"3.1.0","info":{"title":"Polygenic Scores API","version":"1.0.0","description":"Polygenic (risk) scores as an API — powered by the NHGRI-EBI PGS Catalog, the open database of published polygenic scores: weighted combinations of genetic variants used to estimate a person's genetic predisposition to a trait or disease. Search traits by name to find their ontology ids, list every polygenic score developed for a trait, and read a score's full metadata — the reported and mapped (EFO/MONDO) traits, the number of variants in the score, the development method, genome build, the ancestry distribution of the samples it was built and evaluated on, the publication behind it (title, journal, date, PubMed id), the release date, license and a direct link to the scoring file. From breast cancer and coronary artery disease to type 2 diabetes and BMI, it is ideal for statistical genetics, genomics, risk-prediction research and bioinformatics tools. A polygenic-score / genetic-risk-prediction resource — distinct from single-variant association studies (GWAS Catalog), population allele frequencies (gnomAD) and clinical variant interpretation (ClinVar). Open data from the NHGRI-EBI PGS Catalog (CC BY 4.0).","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/pgs-api","description":"oanor gateway"}],"tags":[{"name":"Polygenic Scores"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/score":{"get":{"operationId":"get_v1_score","tags":["Polygenic Scores"],"summary":"A polygenic score's metadata","description":"","parameters":[{"name":"id","in":"query","required":false,"description":"A PGS id","schema":{"type":"string"},"example":"PGS000001"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"score":{"id":"PGS000001","url":"https://www.pgscatalog.org/score/PGS000001/","name":"PRS77_BC","method":"SNPs passing genome-wide significance","traits":[{"id":"MONDO_0004989","label":"breast carcinoma"}],"license":"PGS obtained from the Catalog should be cited appropriately, and used in accordance with any licensing restrictions set by the authors. See EBI Terms of Use (https://www.ebi.ac.uk/about/terms-of-use/)","ancestry":{"eval":{"NR":20,"EUR":80},"gwas":{"EUR":100}},"publication":{"id":"PGP000001","date":"2015-04-08","pmid":25855707,"title":"Prediction of breast cancer risk based on profiling with common genetic variants.","journal":"J Natl Cancer Inst"},"date_release":"2019-10-14","genome_build":"NR","scoring_file":"https://ftp.ebi.ac.uk/pub/databases/spot/pgs/scores/PGS000001/ScoringFiles/PGS000001.txt.gz","trait_reported":"Breast cancer","variants_number":77,"variants_interactions":0}},"meta":{"timestamp":"2026-06-01T16:22:54.675Z","request_id":"ad09c155-5ce8-40a2-98c8-99b2c819cc02"},"status":"ok","message":"Score retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Polygenic Scores"],"summary":"Find traits by name","description":"","parameters":[{"name":"q","in":"query","required":false,"description":"Trait/disease text","schema":{"type":"string"},"example":"breast cancer"},{"name":"limit","in":"query","required":false,"description":"Max results (1-100, default 20)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":12,"query":"breast cancer","total":12,"traits":[{"label":"breast cancer","trait_id":"MONDO_0007254","description":"A primary or metastatic malignant neoplasm involving the breast. The vast majority of cases are carcinomas arising from the breast parenchyma or the nipple. Malignant breast neoplasms occur more frequently in females than in males. [NCIT: C9335]","score_count":0},{"label":"breast carcinoma","trait_id":"MONDO_0004989","description":"A carcinoma that arises from epithelial cells of the breast","score_count":144},{"label":"breast tumor luminal A or B","trait_id":"MONDO_0004990","description":"Subsets of breast carcinoma defined by expression of genes characteristic of luminal epithelial cells. [NCIT: C53554] [NCIT: C53555]","score_count":0},{"label":"estrogen-receptor negative breast cancer","trait_id":"MONDO_0006513","description":"A subtype of breast cancer that is estrogen-receptor negative [EFO: 1000650]","score_count":11},{"label":"estrogen-receptor positive breast cancer","trait_id":"MONDO_0006512","description":"A subtype of breast cancer that is estrogen-receptor positive [EFO: 1000649]","score_count":11},{"label":"family history of breast cancer","trait_id":"EFO_0005606","description":"A reported family history of breast cancer in one or more family members.","score_count":1},{"label":"HER2 positive breast carcinoma","trait_id":"MONDO_0006244","description":"A biologic subset of breast carcinoma defined by high expression of HER2, GRB7, and TRAP100, and by lack of expression of estrogen receptor (ER). [NCIT: C53556]","score_count":1},{"label":"Her2-receptor negative breast cancer","trait_id":"MONDO_0000618","score_count":1},{"label":"luminal A breast carcinoma","trait_id":"MONDO_0021116","description":"A biologic subset of breast carcinoma defined by high expression of genes characteristic of luminal epithelial cells, including estrogen receptor (ER), estrogen regulated protein LIV-1, and the transcription factors hepatocyte nuclear factor 3, HNF3A, XBP1, and GATA 3. This subtype of breast cancer ","score_count":1},{"label":"luminal B breast carcinoma","trait_id":"MONDO_0021115","description":"A biologic subset of breast carcinoma defined by low to moderate expression of genes characteristic of luminal epithelial cells including estrogen receptor (ER), and high expression of GGH, LAPTM4B, and CCNE1. This subtype of breast cancer is associated with a good prognosis, although not as favorab","score_count":1},{"label":"progesterone-receptor negative breast cancer","trait_id":"MONDO_0000616","score_count":0},{"label":"triple-negative breast carcinoma","trait_id":"MONDO_0005494","description":"An invasive breast carcinoma which is negative for expression of estrogen receptor (ER), progesterone receptor (PR), and human epidermal growth factor receptor 2 (HER2). [NCIT: P378]","score_count":8}]},"meta":{"timestamp":"2026-06-01T16:22:54.985Z","request_id":"dbf75cf7-74d0-4cfc-af93-ade615762bf9"},"status":"ok","message":"Traits retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/trait":{"get":{"operationId":"get_v1_trait","tags":["Polygenic Scores"],"summary":"A trait and its polygenic scores","description":"","parameters":[{"name":"id","in":"query","required":false,"description":"Ontology trait id (from /v1/search)","schema":{"type":"string"},"example":"MONDO_0004989"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"trait":{"url":"http://purl.obolibrary.org/obo/MONDO_0004989","label":"breast carcinoma","trait_id":"MONDO_0004989","score_ids":["PGS000001","PGS000004","PGS000007","PGS000015","PGS000028","PGS000029","PGS000045","PGS000050","PGS000051","PGS000052","PGS000072","PGS000153","PGS000317","PGS000332","PGS000335","PGS000344","PGS000345","PGS000472","PGS000473","PGS000474","PGS000475","PGS000476","PGS000477","PGS000478","PGS000479","PGS000480","PGS000481","PGS000482","PGS000483","PGS000484","PGS000485","PGS000486","PGS000487","PGS000488","PGS000489","PGS000490","PGS000491","PGS000492","PGS000493","PGS000494","PGS000495","PGS000496","PGS000497","PGS000498","PGS000499","PGS000500","PGS000501","PGS000502","PGS000503","PGS000504","PGS000505","PGS000506","PGS000507","PGS000508","PGS000509","PGS000510","PGS000511","PGS000512","PGS000513","PGS000514","PGS000515","PGS000516","PGS000517","PGS000518","PGS000519","PGS000520","PGS000521","PGS000522","PGS000523","PGS000524","PGS000525","PGS000526","PGS000527","PGS000528","PGS000529","PGS000530","PGS000531","PGS000532","PGS000533","PGS000534","PGS000535","PGS000536","PGS000537","PGS000538","PGS000539","PGS000540","PGS000773","PGS000783","PGS000873","PGS001336","PGS001778","PGS001804","PGS002015","PGS002242","PGS002294","PGS003380","PGS003396","PGS003397","PGS003398","PGS003399"],"description":"A carcinoma that arises from epithelial cells of the breast","score_count":144}},"meta":{"timestamp":"2026-06-01T16:22:55.183Z","request_id":"699366b8-025d-4f64-8671-a5cf5b152386"},"status":"ok","message":"Trait retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Endpoint catalogue & notes","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"The PGS Catalog is the open database of published polygenic scores (PGS) — weighted sets of genetic variants used to estimate a person's genetic predisposition to a trait or disease. /v1/search?q=breast cancer = find traits by free text, returning matching ontology trait ids (e.g. MONDO_0004989), labels and how many scores exist for each; /v1/trait?id=MONDO_0004989 = a trait's details and the list of polygenic score ids developed for it; /v1/score?id=PGS000001 = a single score's metadata — its name, the reported and mapped (EFO/MONDO) traits, the number of variants, the development method, genome build, ancestry distribution of the samples, the publication behind it (title, journal, date, PubMed id), release date, license and a link to the scoring file. PGS ids look like PGS000001; trait ids are EFO/MONDO/HP/Orphanet identifiers (get them from /v1/search). Data from the NHGRI-EBI PGS Catalog (CC BY 4.0). A polygenic-score / genetic-risk-prediction resource — distinct from single-variant association (GWAS Catalog), population allele frequencies (gnomAD) and clinical variant interpretation (ClinVar). Ideal for statistical genetics, genomics, risk-prediction research and bioinformatics tools.","source":"PGS Catalog — Polygenic Score Catalog, EMBL-EBI (pgscatalog.org)","endpoints":["/v1/search","/v1/trait","/v1/score","/v1/meta"]},"meta":{"timestamp":"2026-06-01T16:22:55.268Z","request_id":"d167fd86-6af1-4483-a808-aef7d3d7a3fe"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":2750,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":735,"monthly_call_quota":53500,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2310,"monthly_call_quota":258000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":6020,"monthly_call_quota":905000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/pgs-api"}