In April 2024, the ROR (Research Organization Registry) released version 2 of the ROR API and schema. What is the timeline of transition to version 2?
Week of July 28, 2025
- ROR API requests with no version in the path will default to v2 instead of v1
This may be a breaking change for applications that use the ROR API with the expectation of a version 1 response, so ROR highly recommends reviewing your ROR API requests and making any necessary updates.
You can continue to retrieve version 1 responses by specifying “v1” in the request:
- No version in the path: https://api.ror.org/organizations
- Version in the path: https://api.ror.org/v1/organizations
Early or mid-December 2025
- V1 documentation will no longer be available
- ROR API requests with v1 in the path will no longer return a response
- V1 files will no longer be included in the ROR data dump
More on changes between version 1 and version 2 of the ROR API and schema