ROR data structure
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"
}
}
}
Updated 8 months ago