|
| 1 | +--- |
| 2 | +title: Changes to associations tsv download file |
| 3 | +author: GWAS Catalog |
| 4 | +description: If you use the GWAS Catalog “All associations” tsv download file, you may have noticed we’ve made some changes.The GWAS Catalog recently passed an incredible milestone of >1m curated associations! This is a huge achievement for the genomics community. However, it presents challenges for some users in analysing the data, since the “All associations” file now has more |
| 5 | +slug: association-file-update |
| 6 | +img: |
| 7 | +date: 2025-11-10 |
| 8 | +displayDate: Nov 10, 2025 |
| 9 | +--- |
| 10 | + |
| 11 | +If you use the GWAS Catalog “All associations” tsv download file, you may have noticed we’ve made some changes. |
| 12 | + |
| 13 | +The GWAS Catalog recently passed an incredible milestone of >1m curated associations! This is a huge achievement for the genomics community. However, it presents challenges for some users in analysing the data, since the “All associations” file now has more than 1m rows. |
| 14 | + |
| 15 | +You now have a choice of two formats for the v1 and v2 “all associations” files: |
| 16 | + |
| 17 | +1. File now provided as a compressed .zip; data format unchanged. |
| 18 | +2. Data split into multiple smaller files, and compressed together. This split file is divided by publication year, with a separate file for each year from 2023 onwards, and pre-2023 data in a single file. |
| 19 | + |
| 20 | +The split file (2) facilitates analysis for users of Excel or other software which cannot handle >1m rows. Please note that data may continue to be added for previous years - you are advised to always work with the latest version of the complete file set. |
| 21 | + |
| 22 | +The files can be downloaded from the ftp links listed on the [file downloads page](https://www.ebi.ac.uk/gwas/docs/file-downloads). |
| 23 | + |
| 24 | +If you’re trying to download the file programmatically for processing, we advise you do so from our [public FTP](https://ftp.ebi.ac.uk/pub/databases/gwas/releases/latest/). The previously available endpoint |
| 25 | +ebi.ac.uk/gwas/api/search/downloads/full was intended for manual access and has been deprecated. |
| 26 | + |
| 27 | +To access subsets of the data, e.g. all associations for a given trait (e.g. “cancer”), you’re advised to either: |
| 28 | +- Use the website to navigate to your data type of interest and then click “download Catalog data” to download relevant associations |
| 29 | +- Use our recently updated [REST API](https://www.ebi.ac.uk/gwas/rest/api/v2/docs) for programmatic access |
| 30 | + |
| 31 | +*Want to receive updates like this directly to your inbox? Sign up for our low-volume mailing list by sending an e-mail to **gwas-announce-join@ebi.ac.uk** with subject heading "subscribe"* |
| 32 | + |
0 commit comments