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.
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 8 days ago