Data dump

A new ROR dataset with the latest additions and changes is released approximately quarterly. See How is ROR updated? for more information on the curation process.

  • Recent ROR datasets are in Zenodo. You can use the Zenodo API to download them, per the instructions below.

  • ROR datasets prior to Sep 2021 are available from Figshare. Copies will be added to Zenodo soon, so that all ROR data dumps will be available in Zenodo.

All ROR IDs and metadata are provided under the Creative Commons CC0 1.0 Universal Public Domain Dedication.

Data dump format

The ROR data dump is released as a single (zipped) JSON file. See ROR data structure for details about the structure of individual organization records.

Data dump versioning

Current

Beginning with its Mar 2022 release, ROR is curated independently from GRID. Semantic versioning beginning with v1.0 has been added to reflect this departure from GRID, however, the data structure has not changed.

From Mar 2022 onward, data releases are versioned as follows:

  • Minor versions (ex 1.1, 1.2, 1.3): Contain changes to data, such as a new records and updates to existing records. No changes to the data model/structure.
  • Patch versions (ex 1.0.1): Used infrequently to correct errors in a release. No changes to the data model/structure.
  • Major versions (ex 1.x, 2.x, 3.x): Contains changes to data model/structure, as well as the data itself. Major versions will be released with significant advance notice.

For convenience, the date is also include in the release file name, ex: v1.0-2022-03-15-ror-data.zip.

Past

From Apr 2019 to Sep 2021, changes to ROR data happened in collaboration with GRID. After each GRID release, ROR assigned new IDs to each new organization in GRID and published a new ROR release that corresponded to the most recent GRID release. Releases were named with with a date, ex 2021-09-23-ror-data.zip.

GRID announced the sunset of its public data offering in July 2022 and published its final data release in Sept 2021. ROR published a corresponding data release (2021-09-23-ror-data.zip) in Sept 2021. Both releases contained the same set of organizations, with GRID and ROR IDs assigned to all.

Download ROR data dumps programmatically with the Zenodo API

  1. Get a list of the records in the ror-data community
curl https://zenodo.org/api/records/?communities=ror-data&sort=mostrecent
  1. In the response, the most recent record will be hits.hits[0]. Find the latest file attached to this record by checking the last item in hits.hits[0].files. The file URL is in links.self within the file object.
...
   "hits" : {
      "hits" : [
         {
            "conceptdoi" : "10.5281/zenodo.6347574",
            "conceptrecid" : "6347574",
            "created" : "2022-06-17T15:07:41.543813+00:00",
            "doi" : "10.5281/zenodo.6657125",
            "files" : [
               {
                  "bucket" : "25d4f93f-6854-4dd4-9954-173197e7fad7",
                  "checksum" : "md5:88307ac74fad1c388f4987c00d09f769",
                  "key" : "v1.0-2022-03-17-ror-data.json.zip",
                  "links" : {
                     "self" : "https://zenodo.org/api/files/25d4f93f-6854-4dd4-9954-173197e7fad7/v1.0-2022-03-17-ror-data.json.zip"
                  },
                  "size" : 20378730,
                  "type" : "zip"
               },
               {
                  "bucket" : "25d4f93f-6854-4dd4-9954-173197e7fad7",
                  "checksum" : "md5:045f3edcb72e323a742e88bf81361a26",
                  "key" : "v1.1-2022-06-16-ror-data.zip",
                  "links" : {
                     "self" : "https://zenodo.org/api/files/25d4f93f-6854-4dd4-9954-173197e7fad7/v1.1-2022-06-16-ror-data.zip"
                  },
                  "size" : 20454781,
                  "type" : "zip"
               }
            ]
...
  1. Download the file to a local directory using the link
curl https://zenodo.org/api/files/25d4f93f-6854-4dd4-9954-173197e7fad7/v1.1-2022-06-16-ror-data.zip

For additional information about retrieving files from Zenodo using the API, see https://developers.zenodo.org/#records