ROR's current data structure is based on Digital Science's GRID, which provided the original seed data for the registry. GRID has retired its public releases as of 16 Sep 2021, and the ROR data structure will evolve over time and based on community feedback as ROR begins to be managed independently from GRID.

ROR metadata

Records will return all fields regardless of whether they have a value. JSON will return null values and empty arrays and objects if there is no value available for the given organization.

Field name	Definition	Type	Required	Value required	Remarks
id	Unique ROR ID for the organization	String	TRUE	TRUE
name	The primary name of the organization	String	TRUE	TRUE
email_address	A contact mail address for the organization	String	FALSE	FALSE	Deprecated field - Not actively curating
ip_addresses	IP address(es) associated with the organization	Array	FALSE	FALSE	Deprecated field - Not actively curating
established	Year the organization was established (CE)	Number	TRUE	FALSE
types	Organization type	Array	TRUE	TRUE	Allowed types: Education, Healthcare, Company, Archive, Nonprofit, Government, Facility, Other
relationships	Related organizations in ROR	Array	TRUE	FALSE	Allowed relationship types: Parent, Child, Related
addresses	The organization's location	Array	TRUE	TRUE
links	Official website of the organization	Array	TRUE	FALSE
aliases	Other names the organization is known by	Array	TRUE	FALSE
acronyms	Acronyms or initialisms for the organization name	Array	TRUE	FALSE
status	Whether the organization is active or not	String	TRUE	TRUE
wikipedia_url	Wikipedia link for the organization	String	TRUE	FALSE
labels	Name(s) for the organization in other language(s)	Array	TRUE	FALSE
country	Country where organization is located	Object	TRUE	TRUE
external_ids	Other identifiers for the organization	Array	TRUE	FALSE	Allowed external IDs: Crossref Funder ID (FundRef), GRID, ISNI, Wikidata. Other external IDs not actively curated include OrgRef, HESA, UCAS, UKPRN, CNRS.

Example record

See the JSON structure in an example organization record.

{
   "id":"https://ror.org/013cjyk83",
   "name":"PSL Research University",
   "email_address":null,
   "ip_addresses":[
      
   ],
   "established":2010,
   "types":[
      "Education"
   ],
   "relationships":[
      {
         "label":"ESPCI Paris",
         "type":"Child",
         "id":"https://ror.org/03zx86w41"
      },
      {
         "label":"Subcellular Structure and Cellular Dynamics",
         "type":"Child",
         "id":"https://ror.org/04w11tv37"
      },
      {
         "label":"École Pratique des Hautes Études",
         "type":"Child",
         "id":"https://ror.org/046b3cj80"
      }
   ],
   "addresses":[
      {
         "lat":48.854692,
         "lng":2.33781,
         "state":null,
         "state_code":null,
         "city":"Paris",
         "geonames_city":{
            "id":2988507,
            "city":"Paris",
            "geonames_admin1":{
               "name":"Île-de-France",
               "id":3012874,
               "ascii_name":"Ile-de-France",
               "code":"FR.11"
            },
            "geonames_admin2":{
               "name":"Paris",
               "id":2968815,
               "ascii_name":"Paris",
               "code":"FR.11.75"
            },
            "license":{
               "attribution":"Data from geonames.org under a CC-BY 3.0 license",
               "license":"http://creativecommons.org/licenses/by/3.0/"
            },
            "nuts_level1":{
               "name":"ÎLE DE FRANCE",
               "code":"FR1"
            },
            "nuts_level2":{
               "name":"Île de France",
               "code":"FR10"
            },
            "nuts_level3":{
               "name":"Paris",
               "code":"FR101"
            }
         },
         "postcode":null,
         "primary":false,
         "line":null,
         "country_geonames_id":3017382
      }
   ],
   "links":[
      "https://www.psl.eu/en/university"
   ],
   "aliases":[
      "Université PSL"
   ],
   "acronyms":[
      "PSL"
   ],
   "status":"active",
   "wikipedia_url":"https://en.wikipedia.org/wiki/PSL_Research_University",
   "labels":[
      {
         "label":"Université de recherche Paris Sciences et Lettres",
         "iso639":"fr"
      }
   ],
   "country":{
      "country_name":"France",
      "country_code":"FR"
   },
   "external_ids":{
      "ISNI":{
         "preferred":null,
         "all":[
            "0000 0004 1784 3645"
         ]
      },
      "OrgRef":{
         "preferred":null,
         "all":[
            "31274670"
         ]
      },
      "Wikidata":{
         "preferred":null,
         "all":[
            "Q1163431"
         ]
      },
      "GRID":{
         "preferred":"grid.440907.e",
         "all":"grid.440907.e"
      }
   }
}