ROR

ROR Support

You’ll find technical docs about ROR tools and services and implementation guides with tips for using these tools/services to address specific use cases, as well as support contacts to help if you get stuck. Let's ROR!

Get Started    

ROR data structure

ROR's current data structure is based on GRID, which provided the original seed data for the registry. The 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"
      }
   }
}

Updated 21 days ago

ROR data structure


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.