Retrieve a single record
ROR REST API v1
This page documents v1 of the ROR REST API. For v2 documentation of the ROR REST API, see https://ror.readme.io/v2/docs/api-single. You can also read more about ROR API versions and a summary of what's new in Schema 2.0 and Schema 2.1.
Changes to the ROR API begin the week of July 28, 2025
Beginning the week of July 28, 2025, ROR API requests with no version in the path will default to responses that use version 2 of the ROR schema instead of version 1. Read more in our changelog.
Formatting single ROR ID requests
When retrieving a single record, you can use any of these formats in the ID portion of your request:
- Full ROR ID URL: https://ror.org/015w2mp89
- Domain and ID: ror.org/015w2mp89
- ID only: 015w2mp89
All formats will return the same record. See ROR identifier pattern for more on ROR ID formats.
Single ROR ID request format
https://api.ror.org/v1/organizations/[ror id]
Example
Request the ROR record for Keimyung University.
curl 'https://api.ror.org/v1/organizations/00tjv0s33' | json_pp
The response is a JSON object containing a full ROR record. See ROR data structure for details about the fields and values in a ROR record.
{
"acronyms" : [
"KMU"
],
"addresses" : [
{
"city" : "Daegu",
"country_geonames_id" : null,
"geonames_city" : {
"city" : "Daegu",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "KR.27",
"id" : null,
"name" : "Daegu"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"id" : 1835329,
"license" : {
"attribution" : "Data from geonames.org under a CC-BY 3.0 license",
"license" : "http://creativecommons.org/licenses/by/3.0/"
},
"nuts_level1" : {
"code" : null,
"name" : null
},
"nuts_level2" : {
"code" : null,
"name" : null
},
"nuts_level3" : {
"code" : null,
"name" : null
}
},
"lat" : 35.87028,
"line" : null,
"lng" : 128.59111,
"postcode" : null,
"primary" : false,
"state" : null,
"state_code" : null
}
],
"aliases" : [
"Kei-dae"
],
"country" : {
"country_code" : "KR",
"country_name" : "South Korea"
},
"email_address" : null,
"established" : 1899,
"external_ids" : {
"FundRef" : {
"all" : [
"501100002509",
"501100006017"
],
"preferred" : "501100002509"
},
"GRID" : {
"all" : "grid.412091.f",
"preferred" : "grid.412091.f"
},
"ISNI" : {
"all" : [
"0000 0001 0669 3109"
],
"preferred" : null
},
"Wikidata" : {
"all" : [
"Q483402"
],
"preferred" : null
}
},
"id" : "https://ror.org/00tjv0s33",
"ip_addresses" : [],
"labels" : [
{
"iso639" : "ko",
"label" : "계명대학교"
}
],
"links" : [
"http://www.kmu.ac.kr/main.jsp"
],
"name" : "Keimyung University",
"relationships" : [
{
"id" : "https://ror.org/035r7hb75",
"label" : "Keimyung University Dongsan Medical Center",
"type" : "Related"
}
],
"status" : "active",
"types" : [
"Education",
"Funder"
],
"wikipedia_url" : "http://en.wikipedia.org/wiki/Keimyung_University"
}
Status and single ROR ID requests
Although as of December 2022 the ROR API defaults to returning only records whose status is active in lists of results, requests for a single specific record by its ROR ID will always return the record even when its status is inactive or withdrawn. Read more about status in ROR data.
Example
curl 'https://api.ror.org/v1/organizations/03fyd9f03' | json_pp
Returns the inactive record for Alcatel-Lucent (United Kingdom).
{
"acronyms" : [],
"addresses" : [
{
"city" : "London",
"country_geonames_id" : null,
"geonames_city" : {
"city" : "London",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "GB.ENG",
"id" : null,
"name" : "England"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"id" : 2643743,
"license" : {
"attribution" : "Data from geonames.org under a CC-BY 3.0 license",
"license" : "http://creativecommons.org/licenses/by/3.0/"
},
"nuts_level1" : {
"code" : null,
"name" : null
},
"nuts_level2" : {
"code" : null,
"name" : null
},
"nuts_level3" : {
"code" : null,
"name" : null
}
},
"lat" : 51.50853,
"line" : null,
"lng" : -0.12574,
"postcode" : null,
"primary" : false,
"state" : null,
"state_code" : null
}
],
"aliases" : [],
"country" : {
"country_code" : "GB",
"country_name" : "United Kingdom"
},
"email_address" : null,
"established" : null,
"external_ids" : {
"GRID" : {
"all" : "grid.425346.2",
"preferred" : "grid.425346.2"
},
"ISNI" : {
"all" : [
"0000 0004 0626 3995"
],
"preferred" : null
},
"Wikidata" : {
"all" : [
"Q28975935"
],
"preferred" : null
}
},
"id" : "https://ror.org/03fyd9f03",
"ip_addresses" : [],
"labels" : [],
"links" : [
"https://www5.alcatel-lucent.com/"
],
"name" : "Alcatel-Lucent (United Kingdom)",
"relationships" : [
{
"id" : "https://ror.org/00zpf0626",
"label" : "Nokia (United Kingdom)",
"type" : "Successor"
}
],
"status" : "inactive",
"types" : [
"Company"
],
"wikipedia_url" : "https://en.wikipedia.org/wiki/Alcatel-Lucent"
}
Updated 3 days ago