Retrieve a single record

👍

ROR REST API v2

This page documents v2 of the ROR REST API. For v1 documentation of the ROR REST API, see https://ror.readme.io/v1/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:

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

Example

Request the ROR record for Keimyung University.

cURL

curl 'https://api.ror.org/v2/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.

JSON

{
   "admin" : {
      "created" : {
         "date" : "2018-11-14",
         "schema_version" : "1.0"
      },
      "last_modified" : {
         "date" : "2021-03-17",
         "schema_version" : "2.0"
      }
   },
   "domains" : [],
   "established" : 1899,
   "external_ids" : [
      {
         "all" : [
            "501100002509",
            "501100006017"
         ],
         "preferred" : "501100002509",
         "type" : "fundref"
      },
      {
         "all" : [
            "grid.412091.f"
         ],
         "preferred" : "grid.412091.f",
         "type" : "grid"
      },
      {
         "all" : [
            "0000 0001 0669 3109"
         ],
         "preferred" : null,
         "type" : "isni"
      },
      {
         "all" : [
            "Q483402"
         ],
         "preferred" : null,
         "type" : "wikidata"
      }
   ],
   "id" : "https://ror.org/00tjv0s33",
   "links" : [
      {
         "type" : "website",
         "value" : "http://www.kmu.ac.kr/main.jsp"
      },
      {
         "type" : "wikipedia",
         "value" : "http://en.wikipedia.org/wiki/Keimyung_University"
      }
   ],
   "locations" : [
      {
         "geonames_details" : {
            "country_code" : "KR",
            "country_name" : "South Korea",
            "lat" : 35.857674,
            "lng" : 128.485571,
            "name" : "Daegu"
         },
         "geonames_id" : 1835329
      }
   ],
   "names" : [
      {
         "lang" : null,
         "types" : [
            "acronym"
         ],
         "value" : "KMU"
      },
      {
         "lang" : null,
         "types" : [
            "alias"
         ],
         "value" : "Kei-dae"
      },
      {
         "lang" : null,
         "types" : [
            "ror_display",
            "label"
         ],
         "value" : "Keimyung University"
      },
      {
         "lang" : "ko",
         "types" : [
            "label"
         ],
         "value" : "계명대학교"
      }
   ],
   "relationships" : [
      {
         "id" : "https://ror.org/035r7hb75",
         "label" : "Keimyung University Dongsan Medical Center",
         "type" : "related"
      }
   ],
   "status" : "active",
   "types" : [
      "education"
   ]
}

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

curl 'https://api.ror.org/v2/organizations/03fyd9f03' | json_pp

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

JSON

{
   "admin" : {
      "created" : {
         "date" : "2018-11-14",
         "schema_version" : "1.0"
      },
      "last_modified" : {
         "date" : "2022-12-06",
         "schema_version" : "2.0"
      }
   },
   "domains" : [],
   "established" : null,
   "external_ids" : [
      {
         "all" : [
            "grid.425346.2"
         ],
         "preferred" : "grid.425346.2",
         "type" : "grid"
      },
      {
         "all" : [
            "0000 0004 0626 3995"
         ],
         "preferred" : null,
         "type" : "isni"
      },
      {
         "all" : [
            "Q28975935"
         ],
         "preferred" : null,
         "type" : "wikidata"
      }
   ],
   "id" : "https://ror.org/03fyd9f03",
   "links" : [
      {
         "type" : "website",
         "value" : "https://www5.alcatel-lucent.com/"
      },
      {
         "type" : "wikipedia",
         "value" : "https://en.wikipedia.org/wiki/Alcatel-Lucent"
      }
   ],
   "locations" : [
      {
         "geonames_details" : {
            "country_code" : "GB",
            "country_name" : "United Kingdom",
            "lat" : 51.50853,
            "lng" : -0.12574,
            "name" : "London"
         },
         "geonames_id" : 2643743
      }
   ],
   "names" : [
      {
         "lang" : null,
         "types" : [
            "ror_display",
            "label"
         ],
         "value" : "Alcatel-Lucent (United Kingdom)"
      }
   ],
   "relationships" : [
      {
         "id" : "https://ror.org/00zpf0626",
         "label" : "Nokia (United Kingdom)",
         "type" : "successor"
      }
   ],
   "status" : "inactive",
   "types" : [
      "company"
   ]
}