Retrieve a single record

1️⃣

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.

Formatting single ROR ID requests

When retrieving a single record, you can use any of these formats in the ID portion of your request:

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/organizations/[ror id]

Example

Request the ROR record for Keimyung University.

curl 'https://api.ror.org/organizations/00tjv0s33'

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" : 1835841,
         "geonames_city" : {
            "city" : "Daegu",
            "geonames_admin1" : {
               "ascii_name" : "Daegu",
               "code" : "KR.15",
               "id" : 1835327,
               "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.857674,
         "line" : null,
         "lng" : 128.485571,
         "postcode" : null,
         "primary" : false,
         "state" : null,
         "state_code" : null
      }
   ],
   "aliases" : [
      "Kei-dae"
   ],
   "country" : {
      "country_code" : "KR",
      "country_name" : "South Korea"
   },
   "email_address" : "",
   "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
      },
      "OrgRef" : {
         "all" : [
            "564378"
         ],
         "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"
   ],
   "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/organizations/03fyd9f03'

Returns the inactive record for Alcatel-Lucent (United Kingdom).

{
   "acronyms" : [],
   "addresses" : [
      {
         "city" : "London",
         "country_geonames_id" : 2635167,
         "geonames_city" : {
            "city" : "London",
            "geonames_admin1" : {
               "ascii_name" : "England",
               "code" : "GB.ENG",
               "id" : 6269131,
               "name" : "England"
            },
            "geonames_admin2" : {
               "ascii_name" : "Greater London",
               "code" : "GB.ENG.GLA",
               "id" : 2648110,
               "name" : "Greater London"
            },
            "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"
}