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 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:

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"
}