REST API
New record status values, filters and API behaviors
Beginning 1 Dec 2022, some ROR records contain new values "inactive" and "withdrawn" in the status and new values "Predecessor" and "Successor" in relationships.type. APIs now return records with active status only by default. Records with all statuses can be returned using query parameter ?all_status. See the 2022-12-01 release notes for details about this change.
The ROR API allows users to retrieve, search and filter the organizations indexed in ROR. The results are returned as JSON. No registration is required to use the ROR API, but note that the rate limit is a maximum of 2000 requests in a 5-minute period, and API traffic can be quite heavy at popular times like midnight UTC. You can also run the entire ROR API locally in Docker.
ROR API status and heartbeat
Is the ROR API up? Check our status page at https://status.ror.org.
Want to do a lightweight health check on the ROR API? Send a request to https://api.ror.org/heartbeat.
Retrieve a single organization record by ROR ID
Retrieve a single ROR record by its ROR ID using the format https://api.ror.org/organizations/<ror id> .
When retrieving a single record, you use any of these formats in the ID portion of your request:
- Full ROR ID URL: https://ror.org/015w2mp89
- Domain and ID: only ror.org/015w2mp89
- ID only : 015w2mp89
All formats will return the same record.
curl https://api.ror.org/organizations/015w2mp89
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" : [
"NPL"
],
"addresses" : [
{
"city" : "London",
"country_geonames_id" : 2635167,
"geonames_city" : {
"city" : "London",
"geonames_admin1" : {
"ascii_name" : "England",
"code" : "GB.ENG",
"id" : 6269131,
"name" : "England"
},
"geonames_admin2" : {
"ascii_name" : "Greater London",
"code" : "GB.ENG.GLA",
"id" : 2648110,
"name" : "Greater London"
},
"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" : "UKI",
"name" : "LONDON"
},
"nuts_level2" : {
"code" : "UKI3",
"name" : "Inner London - West"
},
"nuts_level3" : {
"code" : "UKI32",
"name" : "Westminster"
}
},
"lat" : 51.427184,
"line" : null,
"lng" : -0.344256,
"postcode" : null,
"primary" : false,
"state" : null,
"state_code" : null
}
],
"aliases" : [],
"country" : {
"country_code" : "GB",
"country_name" : "United Kingdom"
},
"email_address" : null,
"established" : 1900,
"external_ids" : {
"GRID" : {
"all" : "grid.410351.2",
"preferred" : "grid.410351.2"
},
"ISNI" : {
"all" : [
"0000 0000 8991 6349"
],
"preferred" : null
},
"OrgRef" : {
"all" : [
"250381"
],
"preferred" : null
},
"Wikidata" : {
"all" : [
"Q1967606"
],
"preferred" : null
}
},
"id" : "https://ror.org/015w2mp89",
"ip_addresses" : [],
"labels" : [],
"links" : [
"http://www.npl.co.uk/"
],
"name" : "National Physical Laboratory",
"relationships" : [],
"status" : "active",
"types" : [
"Facility"
],
"wikipedia_url" : "http://en.wikipedia.org/wiki/National_Physical_Laboratory_(United_Kingdom)"
}
Retrieve a list of organization records
Retrieve the first 10,000 organizations in the ROR search index (paginated, with 20 records on each page), along with summary metadata such as counts of organization by country and type. Note that due to Elasticsearch limitations, you cannot retrieve the entire ROR dataset from the API.
It is not possible to retrieve all ROR records from the API
Elastic Search has an inherent upper limit of 10,000 results, which means that it is currently not possible to retrieve all 100,000+ records from the ROR API. If you need to use the entire ROR dataset in your application, please download the data dump. The API is best for use cases that involve querying or retrieving individual records.
Filtering
This request can be filtered by the organization's type or country. See Filtering below for information about filtering results.
curl https://api.ror.org/organizations
The response is a JSON object containing full records for the first 20 organizations in ROR in the items array and metadata about the entire dataset in the metadata array. See ROR data structure for details about the fields and values in a ROR record.
{
"items" : [
{
"acronyms" : [
"TSU"
],
"addresses" : [
{
"city" : "Houston",
"country_geonames_id" : 6252001,
"geonames_city" : {
"city" : "Houston",
"geonames_admin1" : {
"ascii_name" : "Texas",
"code" : "US.TX",
"id" : 4736286,
"name" : "Texas"
},
"geonames_admin2" : {
"ascii_name" : "Harris County",
"code" : "US.TX.201",
"id" : 4696376,
"name" : "Harris County"
},
"id" : 4699066,
"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" : 29.722222,
"line" : null,
"lng" : -95.361111,
"postcode" : null,
"primary" : false,
"state" : "Texas",
"state_code" : "US-TX"
}
],
"aliases" : [],
"country" : {
"country_code" : "US",
"country_name" : "United States"
},
"email_address" : "",
"established" : 1927,
"external_ids" : {
"GRID" : {
"all" : "grid.264771.1",
"preferred" : "grid.264771.1"
},
"ISNI" : {
"all" : [
"0000 0001 2173 6488"
],
"preferred" : null
},
"OrgRef" : {
"all" : [
"543894",
"7023657"
],
"preferred" : "543894"
},
"Wikidata" : {
"all" : [
"Q626591"
],
"preferred" : null
}
},
"id" : "https://ror.org/05ch0aw77",
"ip_addresses" : [],
"labels" : [],
"links" : [
"http://www.tsu.edu/about/"
],
"name" : "Texas Southern University",
"relationships" : [],
"status" : "active",
"types" : [
"Education"
],
"wikipedia_url" : "http://en.wikipedia.org/wiki/Texas_Southern_University"
},
...
],
"meta" : {
"countries" : [
{
"count" : 30304,
"id" : "us",
"title" : "United States of America"
},
{
"count" : 7273,
"id" : "gb",
"title" : "United Kingdom of Great Britain and Northern Ireland"
},
{
"count" : 4855,
"id" : "de",
"title" : "Federal Republic of Germany"
},
{
"count" : 4651,
"id" : "cn",
"title" : "People's Republic of China"
},
{
"count" : 3885,
"id" : "jp",
"title" : "Japan"
},
{
"count" : 3759,
"id" : "fr",
"title" : "French Republic"
},
{
"count" : 3248,
"id" : "ca",
"title" : "Canada"
},
{
"count" : 2917,
"id" : "in",
"title" : "Republic of India"
},
{
"count" : 2739,
"id" : "cz",
"title" : "Czech Republic"
},
{
"count" : 2019,
"id" : "ru",
"title" : "Russian Federation"
}
],
"types" : [
{
"count" : 29065,
"id" : "company",
"title" : "Company"
},
{
"count" : 19639,
"id" : "education",
"title" : "Education"
},
{
"count" : 13549,
"id" : "nonprofit",
"title" : "Nonprofit"
},
{
"count" : 12689,
"id" : "healthcare",
"title" : "Healthcare"
},
{
"count" : 8795,
"id" : "facility",
"title" : "Facility"
},
{
"count" : 8003,
"id" : "other",
"title" : "Other"
},
{
"count" : 5933,
"id" : "government",
"title" : "Government"
},
{
"count" : 2766,
"id" : "archive",
"title" : "Archive"
}
]
},
"number_of_results" : 100467,
"time_taken" : 9
}
Search ROR records
There are three ways to search ROR records:
-
Query parameter: "Quick search" of
name,aliases,labels,acronymsandexternal_idsfields in ROR records. Works best for searching based on keywords in organization names, searching for exact matches of a name, or searching for an external identifier. This is the recommended search approach for building ROR-powered typeahead widgets that suggest organization names to users. -
Affiliation parameter: Designed to identify an organization when given a long search string that contains not just the organization's name, but also extraneous information such as address or the name of a department. This approach is recommended for matching free-text affiliation strings in existing metadata to ROR IDs.
-
Advanced search: Allows searching of any and all ROR record fields, including
links,addressesandcountry. Complex queries using field names, wildcards, boolean operators, etc can be constructed using Elasticsearch query string syntax. This approach is recommended for research and analysis of the ROR registry, as well as searching for records with very specific characteristics or combinations of data.
Query parameter
"Quick search" of name, aliases, labels, acronyms and external_ids fields in ROR records using the format https://api.ror.org/organizations?query=<search term>.
- The value of the query parameter must be URL-encoded
- Elasticsearch reserved characters such as &, (), / and : must be URL-encoded and escaped using a URL-encoded \ character. See Special characters below for more details.
Paging
This request retrieves only the first 20 records. See Paging below for information about how to retrieve additional results.
Keyword searching using the query parameter
curl https://api.ror.org/organizations?query=bath | json_pp -json_opt pretty,utf8
As with retrieving all organizations, the response is a JSON object containing full records for the first 20 search results.
{
"items" : [
{
"acronyms" : [],
"addresses" : [
{
"city" : "Bath",
"country_geonames_id" : 2635167,
"geonames_city" : {
"city" : "Bath",
"geonames_admin1" : {
"ascii_name" : "England",
"code" : "GB.ENG",
"id" : 6269131,
"name" : "England"
},
"geonames_admin2" : {
"ascii_name" : "Bath and North East Somerset",
"code" : "GB.ENG.A4",
"id" : 3333123,
"name" : "Bath and North East Somerset"
},
"id" : 2656173,
"license" : {
"attribution" : "Data from geonames.org under a CC-BY 3.0 license",
"license" : "http://creativecommons.org/licenses/by/3.0/"
},
"nuts_level1" : {
"code" : "UKK",
"name" : "SOUTH WEST (ENGLAND)"
},
"nuts_level2" : {
"code" : "UKK1",
"name" : "Gloucestershire, Wiltshire and Bristol/Bath area"
},
"nuts_level3" : {
"code" : "UKK12",
"name" : "Bath and North East Somerset, North Somerset and South Gloucestershire"
}
},
"lat" : 51.380148,
"line" : null,
"lng" : -2.362725,
"postcode" : null,
"primary" : false,
"state" : null,
"state_code" : null
}
],
"aliases" : [],
"country" : {
"country_code" : "GB",
"country_name" : "United Kingdom"
},
"email_address" : null,
"established" : 1892,
"external_ids" : {
"GRID" : {
"all" : "grid.468747.e",
"preferred" : "grid.468747.e"
},
"ISNI" : {
"all" : [
"0000 0004 6437 268X"
],
"preferred" : null
},
"OrgRef" : {
"all" : [
"11933767"
],
"preferred" : null
},
"Wikidata" : {
"all" : [
"Q5123579"
],
"preferred" : null
}
},
"id" : "https://ror.org/00pbyj886",
"ip_addresses" : [],
"labels" : [],
"links" : [
"https://www.bathcollege.ac.uk/"
],
"name" : "Bath College",
"relationships" : [],
"status" : "active",
"types" : [
"Education"
],
"wikipedia_url" : "https://en.wikipedia.org/wiki/Bath_College"
},
{
"acronyms" : [],
"addresses" : [
{
"city" : "Bath",
"country_geonames_id" : 2635167,
"geonames_city" : {
"city" : "Bath",
"geonames_admin1" : {
"ascii_name" : "England",
"code" : "GB.ENG",
"id" : 6269131,
"name" : "England"
},
"geonames_admin2" : {
"ascii_name" : "Bath and North East Somerset",
"code" : "GB.ENG.A4",
"id" : 3333123,
"name" : "Bath and North East Somerset"
},
"id" : 2656173,
"license" : {
"attribution" : "Data from geonames.org under a CC-BY 3.0 license",
"license" : "http://creativecommons.org/licenses/by/3.0/"
},
"nuts_level1" : {
"code" : "UKK",
"name" : "SOUTH WEST (ENGLAND)"
},
"nuts_level2" : {
"code" : "UKK1",
"name" : "Gloucestershire, Wiltshire and Bristol/Bath area"
},
"nuts_level3" : {
"code" : "UKK12",
"name" : "Bath and North East Somerset, North Somerset and South Gloucestershire"
}
},
"lat" : 51.386501,
"line" : null,
"lng" : -2.364442,
"postcode" : null,
"primary" : false,
"state" : null,
"state_code" : null
}
],
"aliases" : [],
"country" : {
"country_code" : "GB",
"country_name" : "United Kingdom"
},
"email_address" : null,
"established" : 2003,
"external_ids" : {
"GRID" : {
"all" : "grid.432411.1",
"preferred" : "grid.432411.1"
}
},
"id" : "https://ror.org/04hf68923",
"ip_addresses" : [],
"labels" : [],
"links" : [
"http://www.bathlabs.com/"
],
"name" : "Bath Labs",
"relationships" : [],
"status" : "active",
"types" : [
"Facility"
],
"wikipedia_url" : ""
},
{
"acronyms" : [],
"addresses" : [
{
"city" : "Bath",
"country_geonames_id" : 2635167,
"geonames_city" : {
"city" : "Bath",
"geonames_admin1" : {
"ascii_name" : "England",
"code" : "GB.ENG",
"id" : 6269131,
"name" : "England"
},
"geonames_admin2" : {
"ascii_name" : "Bath and North East Somerset",
"code" : "GB.ENG.A4",
"id" : 3333123,
"name" : "Bath and North East Somerset"
},
"id" : 2656173,
"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.3751,
"line" : null,
"lng" : -2.36172,
"postcode" : null,
"primary" : false,
"state" : null,
"state_code" : null
}
],
"aliases" : [],
"country" : {
"country_code" : "GB",
"country_name" : "United Kingdom"
},
"email_address" : null,
"established" : 1966,
"external_ids" : {
"FundRef" : {
"all" : [
"501100000835"
],
"preferred" : null
},
"GRID" : {
"all" : "grid.7340.0",
"preferred" : "grid.7340.0"
},
"HESA" : {
"all" : [
"0109"
],
"preferred" : null
},
"ISNI" : {
"all" : [
"0000 0001 2162 1699"
],
"preferred" : null
},
"OrgRef" : {
"all" : [
"153992"
],
"preferred" : null
},
"UCAS" : {
"all" : [
"B16"
],
"preferred" : null
},
"UKPRN" : {
"all" : [
"10007850"
],
"preferred" : null
},
"Wikidata" : {
"all" : [
"Q1422458"
],
"preferred" : null
}
},
"id" : "https://ror.org/002h8g185",
"ip_addresses" : [],
"labels" : [],
"links" : [
"http://www.bath.ac.uk/"
],
"name" : "University of Bath",
"relationships" : [
{
"id" : "https://ror.org/00a858n67",
"label" : "Royal United Hospital",
"type" : "Related"
},
{
"id" : "https://ror.org/022p86748",
"label" : "GW4 Facility for High-Resolution Electron Cryo-Microscopy",
"type" : "Related"
},
{
"id" : "https://ror.org/000vekr11",
"label" : "GW4",
"type" : "Related"
}
],
"status" : "active",
"types" : [
"Education"
],
"wikipedia_url" : "http://en.wikipedia.org/wiki/University_of_Bath"
},
{
"acronyms" : [],
"addresses" : [
{
"city" : "Montreal",
"country_geonames_id" : 6251999,
"geonames_city" : {
"city" : "Montréal",
"geonames_admin1" : {
"ascii_name" : "Quebec",
"code" : "CA.10",
"id" : 6115047,
"name" : "Quebec"
},
"geonames_admin2" : {
"ascii_name" : "Montreal",
"code" : "CA.10.06",
"id" : 6077246,
"name" : "Montréal"
},
"id" : 6077243,
"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" : 45.437374,
"line" : null,
"lng" : -73.659299,
"postcode" : null,
"primary" : false,
"state" : "Quebec",
"state_code" : "CA-QC"
}
],
"aliases" : [],
"country" : {
"country_code" : "CA",
"country_name" : "Canada"
},
"email_address" : null,
"established" : 1969,
"external_ids" : {
"GRID" : {
"all" : "grid.474071.1",
"preferred" : "grid.474071.1"
}
},
"id" : "https://ror.org/03zhn2w96",
"ip_addresses" : [],
"labels" : [],
"links" : [
"http://www.maax.com/en"
],
"name" : "MAAX Bath (Canada)",
"relationships" : [],
"status" : "active",
"types" : [
"Company"
],
"wikipedia_url" : ""
},
{
"acronyms" : [],
"addresses" : [
{
"city" : "Bath",
"country_geonames_id" : 6252001,
"geonames_city" : {
"city" : "Bath",
"geonames_admin1" : {
"ascii_name" : "Maine",
"code" : "US.ME",
"id" : 4971068,
"name" : "Maine"
},
"geonames_admin2" : {
"ascii_name" : "Sagadahoc County",
"code" : "US.ME.023",
"id" : 4977278,
"name" : "Sagadahoc County"
},
"id" : 4957570,
"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" : 43.893975,
"line" : null,
"lng" : -69.815909,
"postcode" : null,
"primary" : false,
"state" : "Maine",
"state_code" : "US-ME"
}
],
"aliases" : [
"Bath Marine Museum"
],
"country" : {
"country_code" : "US",
"country_name" : "United States"
},
"email_address" : null,
"established" : 1962,
"external_ids" : {
"GRID" : {
"all" : "grid.447036.2",
"preferred" : "grid.447036.2"
},
"ISNI" : {
"all" : [
"0000 0001 2226 6326"
],
"preferred" : null
}
},
"id" : "https://ror.org/0277k6k46",
"ip_addresses" : [],
"labels" : [],
"links" : [
"http://www.mainemaritimemuseum.org/"
],
"name" : "Maine Maritime Museum",
"relationships" : [],
"status" : "active",
"types" : [
"Archive"
],
"wikipedia_url" : "https://en.wikipedia.org/wiki/Maine_Maritime_Museum"
},
{
"acronyms" : [],
"addresses" : [
{
"city" : "Bath",
"country_geonames_id" : 2635167,
"geonames_city" : {
"city" : "Bath",
"geonames_admin1" : {
"ascii_name" : "England",
"code" : "GB.ENG",
"id" : 6269131,
"name" : "England"
},
"geonames_admin2" : {
"ascii_name" : "Bath and North East Somerset",
"code" : "GB.ENG.A4",
"id" : 3333123,
"name" : "Bath and North East Somerset"
},
"id" : 2656173,
"license" : {
"attribution" : "Data from geonames.org under a CC-BY 3.0 license",
"license" : "http://creativecommons.org/licenses/by/3.0/"
},
"nuts_level1" : {
"code" : "UKK",
"name" : "SOUTH WEST (ENGLAND)"
},
"nuts_level2" : {
"code" : "UKK1",
"name" : "Gloucestershire, Wiltshire and Bristol/Bath area"
},
"nuts_level3" : {
"code" : "UKK12",
"name" : "Bath and North East Somerset, North Somerset and South Gloucestershire"
}
},
"lat" : 51.37598,
"line" : null,
"lng" : -2.438833,
"postcode" : null,
"primary" : false,
"state" : "Bath and North East Somerset",
"state_code" : "GB-BAS"
}
],
"aliases" : [
"Bath College of Higher Education",
"Bath Spa University College"
],
"country" : {
"country_code" : "GB",
"country_name" : "United Kingdom"
},
"email_address" : null,
"established" : 2005,
"external_ids" : {
"FundRef" : {
"all" : [
"100010331"
],
"preferred" : null
},
"GRID" : {
"all" : "grid.252874.e",
"preferred" : "grid.252874.e"
},
"HESA" : {
"all" : [
"0048"
],
"preferred" : null
},
"ISNI" : {
"all" : [
"0000 0001 2034 9451"
],
"preferred" : null
},
"OrgRef" : {
"all" : [
"818426"
],
"preferred" : null
},
"UCAS" : {
"all" : [
"B20"
],
"preferred" : null
},
"UKPRN" : {
"all" : [
"10000571"
],
"preferred" : null
},
"Wikidata" : {
"all" : [
"Q3091754"
],
"preferred" : null
}
},
"id" : "https://ror.org/0038jbq24",
"ip_addresses" : [],
"labels" : [],
"links" : [
"https://www.bathspa.ac.uk/"
],
"name" : "Bath Spa University",
"relationships" : [],
"status" : "active",
"types" : [
"Education"
],
"wikipedia_url" : "http://en.wikipedia.org/wiki/Bath_Spa_University"
},
{
"acronyms" : [],
"addresses" : [
{
"city" : "Bath Beach",
"country_geonames_id" : 6252001,
"geonames_city" : {
"city" : "Bath Beach",
"geonames_admin1" : {
"ascii_name" : "New York",
"code" : "US.NY",
"id" : 5128638,
"name" : "New York"
},
"geonames_admin2" : {
"ascii_name" : "Kings County",
"code" : "US.NY.047",
"id" : 6941775,
"name" : "Kings County"
},
"id" : 5108111,
"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" : 42.343611,
"line" : null,
"lng" : -77.346111,
"postcode" : null,
"primary" : false,
"state" : "New York",
"state_code" : "US-NY"
}
],
"aliases" : [],
"country" : {
"country_code" : "US",
"country_name" : "United States"
},
"email_address" : null,
"established" : 1878,
"external_ids" : {
"GRID" : {
"all" : "grid.509313.d",
"preferred" : "grid.509313.d"
},
"ISNI" : {
"all" : [
"0000 0004 0420 1096"
],
"preferred" : null
},
"Wikidata" : {
"all" : [
"Q4868960"
],
"preferred" : null
}
},
"id" : "https://ror.org/01d4n7s11",
"ip_addresses" : [],
"labels" : [],
"links" : [
"https://www.fingerlakes.va.gov/locations/Bath_VA_Medical_Center.asp"
],
"name" : "Bath VA Medical Center",
"relationships" : [
{
"id" : "https://ror.org/01rkxdk30",
"label" : "VA Finger Lakes Healthcare System",
"type" : "Parent"
}
],
"status" : "active",
"types" : [
"Healthcare"
],
"wikipedia_url" : "https://en.wikipedia.org/wiki/Bath_VA_Medical_Center"
},
{
"acronyms" : [],
"addresses" : [
{
"city" : "Bath",
"country_geonames_id" : 2635167,
"geonames_city" : {
"city" : "Bath",
"geonames_admin1" : {
"ascii_name" : "England",
"code" : "GB.ENG",
"id" : 6269131,
"name" : "England"
},
"geonames_admin2" : {
"ascii_name" : "Bath and North East Somerset",
"code" : "GB.ENG.A4",
"id" : 3333123,
"name" : "Bath and North East Somerset"
},
"id" : 2656173,
"license" : {
"attribution" : "Data from geonames.org under a CC-BY 3.0 license",
"license" : "http://creativecommons.org/licenses/by/3.0/"
},
"nuts_level1" : {
"code" : "UKK",
"name" : "SOUTH WEST (ENGLAND)"
},
"nuts_level2" : {
"code" : "UKK1",
"name" : "Gloucestershire, Wiltshire and Bristol/Bath area"
},
"nuts_level3" : {
"code" : "UKK12",
"name" : "Bath and North East Somerset, North Somerset and South Gloucestershire"
}
},
"lat" : 51.391294,
"line" : null,
"lng" : -2.393219,
"postcode" : null,
"primary" : false,
"state" : null,
"state_code" : null
}
],
"aliases" : [
"Bath Institute of Medical Engineering"
],
"country" : {
"country_code" : "GB",
"country_name" : "United Kingdom"
},
"email_address" : null,
"established" : 1968,
"external_ids" : {
"GRID" : {
"all" : "grid.486748.1",
"preferred" : "grid.486748.1"
},
"ISNI" : {
"all" : [
"0000 0004 0449 0078"
],
"preferred" : null
}
},
"id" : "https://ror.org/01datx010",
"ip_addresses" : [],
"labels" : [],
"links" : [
"http://www.designability.org.uk/"
],
"name" : "Designability",
"relationships" : [],
"status" : "active",
"types" : [
"Nonprofit"
],
"wikipedia_url" : "https://en.wikipedia.org/wiki/Bath_Institute_of_Medical_Engineering"
},
{
"acronyms" : [
"BSDR"
],
"addresses" : [
{
"city" : "Bath",
"country_geonames_id" : 2635167,
"geonames_city" : {
"city" : "Bath",
"geonames_admin1" : {
"ascii_name" : "England",
"code" : "GB.ENG",
"id" : 6269131,
"name" : "England"
},
"geonames_admin2" : {
"ascii_name" : "Bath and North East Somerset",
"code" : "GB.ENG.A4",
"id" : 3333123,
"name" : "Bath and North East Somerset"
},
"id" : 2656173,
"license" : {
"attribution" : "Data from geonames.org under a CC-BY 3.0 license",
"license" : "http://creativecommons.org/licenses/by/3.0/"
},
"nuts_level1" : {
"code" : "UKK",
"name" : "SOUTH WEST (ENGLAND)"
},
"nuts_level2" : {
"code" : "UKK1",
"name" : "Gloucestershire, Wiltshire and Bristol/Bath area"
},
"nuts_level3" : {
"code" : "UKK12",
"name" : "Bath and North East Somerset, North Somerset and South Gloucestershire"
}
},
"lat" : 51.387285,
"line" : null,
"lng" : -2.397273,
"postcode" : null,
"primary" : false,
"state" : null,
"state_code" : null
}
],
"aliases" : [],
"country" : {
"country_code" : "GB",
"country_name" : "United Kingdom"
},
"email_address" : null,
"established" : 2016,
"external_ids" : {
"GRID" : {
"all" : "grid.499705.6",
"preferred" : "grid.499705.6"
}
},
"id" : "https://ror.org/02fzzq880",
"ip_addresses" : [],
"labels" : [],
"links" : [
"http://bathsdr.org/"
],
"name" : "Bath Social and Development Research",
"relationships" : [],
"status" : "active",
"types" : [
"Nonprofit"
],
"wikipedia_url" : ""
},
{
"acronyms" : [
"BBSP"
],
"addresses" : [
{
"city" : "Bristol",
"country_geonames_id" : 2635167,
"geonames_city" : {
"city" : "Bristol",
"geonames_admin1" : {
"ascii_name" : "England",
"code" : "GB.ENG",
"id" : 6269131,
"name" : "England"
},
"geonames_admin2" : {
"ascii_name" : "City of Bristol",
"code" : "GB.ENG.B7",
"id" : 3333134,
"name" : "City of Bristol"
},
"id" : 2654675,
"license" : {
"attribution" : "Data from geonames.org under a CC-BY 3.0 license",
"license" : "http://creativecommons.org/licenses/by/3.0/"
},
"nuts_level1" : {
"code" : "UKK",
"name" : "SOUTH WEST (ENGLAND)"
},
"nuts_level2" : {
"code" : "UKK1",
"name" : "Gloucestershire, Wiltshire and Bristol/Bath area"
},
"nuts_level3" : {
"code" : "UKK12",
"name" : "Bath and North East Somerset, North Somerset and South Gloucestershire"
}
},
"lat" : 51.501223,
"line" : null,
"lng" : -2.478679,
"postcode" : null,
"primary" : false,
"state" : null,
"state_code" : null
}
],
"aliases" : [],
"country" : {
"country_code" : "GB",
"country_name" : "United Kingdom"
},
"email_address" : null,
"established" : 2011,
"external_ids" : {
"GRID" : {
"all" : "grid.498158.9",
"preferred" : "grid.498158.9"
}
},
"id" : "https://ror.org/0105p2r38",
"ip_addresses" : [],
"labels" : [],
"links" : [
"https://www.bbsp.co.uk/"
],
"name" : "Bristol and Bath Science Park",
"relationships" : [],
"status" : "active",
"types" : [
"Education"
],
"wikipedia_url" : "https://en.wikipedia.org/wiki/Bristol_and_Bath_Science_Park"
},
{
"acronyms" : [
"BRLSI"
],
"addresses" : [
{
"city" : "Bath",
"country_geonames_id" : 2635167,
"geonames_city" : {
"city" : "Bath",
"geonames_admin1" : {
"ascii_name" : "England",
"code" : "GB.ENG",
"id" : 6269131,
"name" : "England"
},
"geonames_admin2" : {
"ascii_name" : "Bath and North East Somerset",
"code" : "GB.ENG.A4",
"id" : 3333123,
"name" : "Bath and North East Somerset"
},
"id" : 2656173,
"license" : {
"attribution" : "Data from geonames.org under a CC-BY 3.0 license",
"license" : "http://creativecommons.org/licenses/by/3.0/"
},
"nuts_level1" : {
"code" : "UKK",
"name" : "SOUTH WEST (ENGLAND)"
},
"nuts_level2" : {
"code" : "UKK1",
"name" : "Gloucestershire, Wiltshire and Bristol/Bath area"
},
"nuts_level3" : {
"code" : "UKK12",
"name" : "Bath and North East Somerset, North Somerset and South Gloucestershire"
}
},
"lat" : 51.383589,
"line" : null,
"lng" : -2.364374,
"postcode" : null,
"primary" : false,
"state" : null,
"state_code" : null
}
],
"aliases" : [
"Bath Literary and Scientific Institution"
],
"country" : {
"country_code" : "GB",
"country_name" : "United Kingdom"
},
"email_address" : null,
"established" : 1824,
"external_ids" : {
"GRID" : {
"all" : "grid.493239.6",
"preferred" : "grid.493239.6"
}
},
"id" : "https://ror.org/046jgev73",
"ip_addresses" : [],
"labels" : [],
"links" : [
"https://www.brlsi.org/"
],
"name" : "Bath Royal Literary and Scientific Institution",
"relationships" : [],
"status" : "active",
"types" : [
"Other"
],
"wikipedia_url" : "https://en.wikipedia.org/wiki/Bath_Royal_Literary_and_Scientific_Institution"
},
{
"acronyms" : [
"BIRD"
],
"addresses" : [
{
"city" : "Bath",
"country_geonames_id" : 2635167,
"geonames_city" : {
"city" : "Bath",
"geonames_admin1" : {
"ascii_name" : "England",
"code" : "GB.ENG",
"id" : 6269131,
"name" : "England"
},
"geonames_admin2" : {
"ascii_name" : "Bath and North East Somerset",
"code" : "GB.ENG.A4",
"id" : 3333123,
"name" : "Bath and North East Somerset"
},
"id" : 2656173,
"license" : {
"attribution" : "Data from geonames.org under a CC-BY 3.0 license",
"license" : "http://creativecommons.org/licenses/by/3.0/"
},
"nuts_level1" : {
"code" : "UKK",
"name" : "SOUTH WEST (ENGLAND)"
},
"nuts_level2" : {
"code" : "UKK1",
"name" : "Gloucestershire, Wiltshire and Bristol/Bath area"
},
"nuts_level3" : {
"code" : "UKK12",
"name" : "Bath and North East Somerset, North Somerset and South Gloucestershire"
}
},
"lat" : 51.382563,
"line" : null,
"lng" : -2.36202,
"postcode" : null,
"primary" : false,
"state" : null,
"state_code" : null
}
],
"aliases" : [],
"country" : {
"country_code" : "GB",
"country_name" : "United Kingdom"
},
"email_address" : null,
"established" : 1975,
"external_ids" : {
"GRID" : {
"all" : "grid.418231.d",
"preferred" : "grid.418231.d"
},
"ISNI" : {
"all" : [
"0000 0004 0641 831X"
],
"preferred" : null
},
"Wikidata" : {
"all" : [
"Q30281630"
],
"preferred" : null
}
},
"id" : "https://ror.org/05tacab76",
"ip_addresses" : [],
"labels" : [],
"links" : [
"http://www.birdbath.org.uk/"
],
"name" : "Bath Institute for Rheumatic Diseases",
"relationships" : [],
"status" : "active",
"types" : [
"Nonprofit"
],
"wikipedia_url" : ""
},
{
"acronyms" : [],
"addresses" : [
{
"city" : "Bath",
"country_geonames_id" : 2635167,
"geonames_city" : {
"city" : "Bath",
"geonames_admin1" : {
"ascii_name" : "England",
"code" : "GB.ENG",
"id" : 6269131,
"name" : "England"
},
"geonames_admin2" : {
"ascii_name" : "Bath and North East Somerset",
"code" : "GB.ENG.A4",
"id" : 3333123,
"name" : "Bath and North East Somerset"
},
"id" : 2656173,
"license" : {
"attribution" : "Data from geonames.org under a CC-BY 3.0 license",
"license" : "http://creativecommons.org/licenses/by/3.0/"
},
"nuts_level1" : {
"code" : "UKK",
"name" : "SOUTH WEST (ENGLAND)"
},
"nuts_level2" : {
"code" : "UKK1",
"name" : "Gloucestershire, Wiltshire and Bristol/Bath area"
},
"nuts_level3" : {
"code" : "UKK12",
"name" : "Bath and North East Somerset, North Somerset and South Gloucestershire"
}
},
"lat" : 51.415436,
"line" : null,
"lng" : -2.491173,
"postcode" : null,
"primary" : false,
"state" : null,
"state_code" : null
}
],
"aliases" : [],
"country" : {
"country_code" : "GB",
"country_name" : "United Kingdom"
},
"email_address" : "",
"established" : 1996,
"external_ids" : {
"GRID" : {
"all" : "grid.450510.5",
"preferred" : "grid.450510.5"
},
"ISNI" : {
"all" : [
"0000 0004 0374 2966"
],
"preferred" : null
},
"Wikidata" : {
"all" : [
"Q16966588"
],
"preferred" : null
}
},
"id" : "https://ror.org/03rwxcx12",
"ip_addresses" : [],
"labels" : [],
"links" : [
"http://www.bathnes.gov.uk/"
],
"name" : "Bath and North East Somerset Council",
"relationships" : [],
"status" : "active",
"types" : [
"Government"
],
"wikipedia_url" : "https://en.wikipedia.org/wiki/Bath_and_North_East_Somerset_Council"
},
{
"acronyms" : [],
"addresses" : [
{
"city" : "Bath",
"country_geonames_id" : 2635167,
"geonames_city" : {
"city" : "Bath",
"geonames_admin1" : {
"ascii_name" : "England",
"code" : "GB.ENG",
"id" : 6269131,
"name" : "England"
},
"geonames_admin2" : {
"ascii_name" : "Bath and North East Somerset",
"code" : "GB.ENG.A4",
"id" : 3333123,
"name" : "Bath and North East Somerset"
},
"id" : 2656173,
"license" : {
"attribution" : "Data from geonames.org under a CC-BY 3.0 license",
"license" : "http://creativecommons.org/licenses/by/3.0/"
},
"nuts_level1" : {
"code" : "UKK",
"name" : "SOUTH WEST (ENGLAND)"
},
"nuts_level2" : {
"code" : "UKK1",
"name" : "Gloucestershire, Wiltshire and Bristol/Bath area"
},
"nuts_level3" : {
"code" : "UKK12",
"name" : "Bath and North East Somerset, North Somerset and South Gloucestershire"
}
},
"lat" : 51.391932,
"line" : null,
"lng" : -2.389183,
"postcode" : null,
"primary" : false,
"state" : "Somerset",
"state_code" : "GB-SOM"
}
],
"aliases" : [
"Royal United Hospital Bath NHS Foundation Trust"
],
"country" : {
"country_code" : "GB",
"country_name" : "United Kingdom"
},
"email_address" : null,
"established" : 1864,
"external_ids" : {
"GRID" : {
"all" : "grid.413029.d",
"preferred" : "grid.413029.d"
},
"ISNI" : {
"all" : [
"0000 0004 0374 2907"
],
"preferred" : null
},
"OrgRef" : {
"all" : [
"26346979"
],
"preferred" : null
},
"Wikidata" : {
"all" : [
"Q18162105"
],
"preferred" : null
}
},
"id" : "https://ror.org/058x7dy48",
"ip_addresses" : [],
"labels" : [],
"links" : [
"http://www.ruh.nhs.uk/"
],
"name" : "Royal United Hospital Bath NHS Trust",
"relationships" : [
{
"id" : "https://ror.org/05f9e0404",
"label" : "Paulton Hospital",
"type" : "Child"
},
{
"id" : "https://ror.org/05va5gy74",
"label" : "Royal National Hospital for Rheumatic Diseases",
"type" : "Child"
},
{
"id" : "https://ror.org/00a858n67",
"label" : "Royal United Hospital",
"type" : "Child"
}
],
"status" : "active",
"types" : [
"Healthcare"
],
"wikipedia_url" : "https://en.wikipedia.org/wiki/Royal_United_Hospital_Bath_NHS_Foundation_Trust"
},
{
"acronyms" : [
"BaNES CCG"
],
"addresses" : [
{
"city" : "Bath",
"country_geonames_id" : 2635167,
"geonames_city" : {
"city" : "Bath",
"geonames_admin1" : {
"ascii_name" : "England",
"code" : "GB.ENG",
"id" : 6269131,
"name" : "England"
},
"geonames_admin2" : {
"ascii_name" : "Bath and North East Somerset",
"code" : "GB.ENG.A4",
"id" : 3333123,
"name" : "Bath and North East Somerset"
},
"id" : 2656173,
"license" : {
"attribution" : "Data from geonames.org under a CC-BY 3.0 license",
"license" : "http://creativecommons.org/licenses/by/3.0/"
},
"nuts_level1" : {
"code" : "UKK",
"name" : "SOUTH WEST (ENGLAND)"
},
"nuts_level2" : {
"code" : "UKK1",
"name" : "Gloucestershire, Wiltshire and Bristol/Bath area"
},
"nuts_level3" : {
"code" : "UKK12",
"name" : "Bath and North East Somerset, North Somerset and South Gloucestershire"
}
},
"lat" : 51.35779,
"line" : null,
"lng" : -2.372919,
"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.476920.e",
"preferred" : "grid.476920.e"
}
},
"id" : "https://ror.org/00pkb6h65",
"ip_addresses" : [],
"labels" : [],
"links" : [
"http://www.bathandnortheastsomersetccg.nhs.uk/"
],
"name" : "Bath and North East Somerset Clinical Commissioning Group",
"relationships" : [],
"status" : "active",
"types" : [
"Healthcare"
],
"wikipedia_url" : ""
}
],
"meta" : {
"countries" : [
{
"count" : 12,
"id" : "gb",
"title" : "United Kingdom"
},
{
"count" : 2,
"id" : "us",
"title" : "United States"
},
{
"count" : 1,
"id" : "ca",
"title" : "Canada"
}
],
"types" : [
{
"count" : 4,
"id" : "education",
"title" : "Education"
},
{
"count" : 3,
"id" : "healthcare",
"title" : "Healthcare"
},
{
"count" : 3,
"id" : "nonprofit",
"title" : "Nonprofit"
},
{
"count" : 1,
"id" : "archive",
"title" : "Archive"
},
{
"count" : 1,
"id" : "company",
"title" : "Company"
},
{
"count" : 1,
"id" : "facility",
"title" : "Facility"
},
{
"count" : 1,
"id" : "government",
"title" : "Government"
},
{
"count" : 1,
"id" : "other",
"title" : "Other"
}
]
},
"number_of_results" : 15,
"time_taken" : 9
}
Exact string searching using quotation marks and the query parameter
Keyword searches can produce hundreds or thousands of results, especially when the string contains common terms such as "University," "Health," or "Ministry." Surrounding a string with quotation marks will reduce the number of results in the response, limiting the results to records with exact matches to that string. Quotation marks must be URL-encoded.
See Search strings with spaces below for more explanation.
curl https://api.ror.org/organizations?query=%22Bath%20College%22 | json_pp -json_opt pretty,utf8
{
"items" : [
{
"acronyms" : [],
"addresses" : [
{
"city" : "Bath",
"country_geonames_id" : 2635167,
"geonames_city" : {
"city" : "Bath",
"geonames_admin1" : {
"ascii_name" : "England",
"code" : "GB.ENG",
"id" : 6269131,
"name" : "England"
},
"geonames_admin2" : {
"ascii_name" : "Bath and North East Somerset",
"code" : "GB.ENG.A4",
"id" : 3333123,
"name" : "Bath and North East Somerset"
},
"id" : 2656173,
"license" : {
"attribution" : "Data from geonames.org under a CC-BY 3.0 license",
"license" : "http://creativecommons.org/licenses/by/3.0/"
},
"nuts_level1" : {
"code" : "UKK",
"name" : "SOUTH WEST (ENGLAND)"
},
"nuts_level2" : {
"code" : "UKK1",
"name" : "Gloucestershire, Wiltshire and Bristol/Bath area"
},
"nuts_level3" : {
"code" : "UKK12",
"name" : "Bath and North East Somerset, North Somerset and South Gloucestershire"
}
},
"lat" : 51.380148,
"line" : null,
"lng" : -2.362725,
"postcode" : null,
"primary" : false,
"state" : null,
"state_code" : null
}
],
"aliases" : [],
"country" : {
"country_code" : "GB",
"country_name" : "United Kingdom"
},
"email_address" : null,
"established" : 1892,
"external_ids" : {
"GRID" : {
"all" : "grid.468747.e",
"preferred" : "grid.468747.e"
},
"ISNI" : {
"all" : [
"0000 0004 6437 268X"
],
"preferred" : null
},
"OrgRef" : {
"all" : [
"11933767"
],
"preferred" : null
},
"Wikidata" : {
"all" : [
"Q5123579"
],
"preferred" : null
}
},
"id" : "https://ror.org/00pbyj886",
"ip_addresses" : [],
"labels" : [],
"links" : [
"https://www.bathcollege.ac.uk/"
],
"name" : "Bath College",
"relationships" : [],
"status" : "active",
"types" : [
"Education"
],
"wikipedia_url" : "https://en.wikipedia.org/wiki/Bath_College"
},
{
"acronyms" : [],
"addresses" : [
{
"city" : "Bath",
"country_geonames_id" : 2635167,
"geonames_city" : {
"city" : "Bath",
"geonames_admin1" : {
"ascii_name" : "England",
"code" : "GB.ENG",
"id" : 6269131,
"name" : "England"
},
"geonames_admin2" : {
"ascii_name" : "Bath and North East Somerset",
"code" : "GB.ENG.A4",
"id" : 3333123,
"name" : "Bath and North East Somerset"
},
"id" : 2656173,
"license" : {
"attribution" : "Data from geonames.org under a CC-BY 3.0 license",
"license" : "http://creativecommons.org/licenses/by/3.0/"
},
"nuts_level1" : {
"code" : "UKK",
"name" : "SOUTH WEST (ENGLAND)"
},
"nuts_level2" : {
"code" : "UKK1",
"name" : "Gloucestershire, Wiltshire and Bristol/Bath area"
},
"nuts_level3" : {
"code" : "UKK12",
"name" : "Bath and North East Somerset, North Somerset and South Gloucestershire"
}
},
"lat" : 51.37598,
"line" : null,
"lng" : -2.438833,
"postcode" : null,
"primary" : false,
"state" : "Bath and North East Somerset",
"state_code" : "GB-BAS"
}
],
"aliases" : [
"Bath College of Higher Education",
"Bath Spa University College"
],
"country" : {
"country_code" : "GB",
"country_name" : "United Kingdom"
},
"email_address" : null,
"established" : 2005,
"external_ids" : {
"FundRef" : {
"all" : [
"100010331"
],
"preferred" : null
},
"GRID" : {
"all" : "grid.252874.e",
"preferred" : "grid.252874.e"
},
"HESA" : {
"all" : [
"0048"
],
"preferred" : null
},
"ISNI" : {
"all" : [
"0000 0001 2034 9451"
],
"preferred" : null
},
"OrgRef" : {
"all" : [
"818426"
],
"preferred" : null
},
"UCAS" : {
"all" : [
"B20"
],
"preferred" : null
},
"UKPRN" : {
"all" : [
"10000571"
],
"preferred" : null
},
"Wikidata" : {
"all" : [
"Q3091754"
],
"preferred" : null
}
},
"id" : "https://ror.org/0038jbq24",
"ip_addresses" : [],
"labels" : [],
"links" : [
"https://www.bathspa.ac.uk/"
],
"name" : "Bath Spa University",
"relationships" : [],
"status" : "active",
"types" : [
"Education"
],
"wikipedia_url" : "http://en.wikipedia.org/wiki/Bath_Spa_University"
}
],
"meta" : {
"countries" : [
{
"count" : 2,
"id" : "gb",
"title" : "United Kingdom"
}
],
"types" : [
{
"count" : 2,
"id" : "education",
"title" : "Education"
}
]
},
"number_of_results" : 2,
"time_taken" : 336
}
Searching for external identifiers using the query parameter
The query parameter search approach searches the external_ids field and so can be used to search for ROR records that match an external identifier. Use URL-encoded quotation marks before and after the identifier search string for best results.
curl https://api.ror.org/organizations?query=%22grid.453259.c%22 | json_pp -json_opt pretty,utf8
Because the query parameter search does not search relationships fields, only the single record with the searched-for identifier in the external_ids field will be returned.
{
"items" : [
{
"acronyms" : [],
"addresses" : [
{
"city" : "Townsville",
"country_geonames_id" : 2077456,
"geonames_city" : {
"city" : "Townsville",
"geonames_admin1" : {
"ascii_name" : "Queensland",
"code" : "AU.04",
"id" : 2152274,
"name" : "Queensland"
},
"geonames_admin2" : {
"ascii_name" : "Townsville",
"code" : "AU.04.37010",
"id" : 7839399,
"name" : "Townsville"
},
"id" : 2146142,
"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" : -19.25862,
"line" : null,
"lng" : 146.816937,
"postcode" : null,
"primary" : false,
"state" : "Queensland",
"state_code" : "AU-QLD"
}
],
"aliases" : [],
"country" : {
"country_code" : "AU",
"country_name" : "Australia"
},
"email_address" : null,
"established" : 2014,
"external_ids" : {
"GRID" : {
"all" : "grid.508402.b",
"preferred" : "grid.508402.b"
}
},
"id" : "https://ror.org/0249xx705",
"ip_addresses" : [],
"labels" : [],
"links" : [
"https://reefecologic.org/"
],
"name" : "Reef Ecologic",
"relationships" : [],
"status" : "active",
"types" : [
"Nonprofit"
],
"wikipedia_url" : ""
}
],
"meta" : {
"countries" : [
{
"count" : 1,
"id" : "au",
"title" : "Australia"
}
],
"types" : [
{
"count" : 1,
"id" : "nonprofit",
"title" : "Nonprofit"
}
]
},
"number_of_results" : 1,
"time_taken" : 15
}
Filtering
Query requests can be filtered by the organization's type or country. See Filtering below for information about filtering results.
Affiliation parameter
Designed to identify an organization when given a long search string that contains not just the organization's name, but also extraneous information such as address or the name of a department. Breaks search strings into multiple substrings at spaces and special characters, performs multiple searches of name-related fields only (name, aliases, labels and acronym) using several different search algorithms, and returns the best result(s) based on matching score using the format https://api.ror.org/organizations?affiliation=<URL-encoded string>. If a country name or ISO code is included, results are limited to records with that country in the country field.
Can match messy strings to ROR IDs at about 85% efficacy depending on implementation. Because of the high number of same/similar names among research institutions globally, we recommend human review of matches.
- Only results with a matching score of at least .5 are returned.
- The value of the affiliation parameter must be URL-encoded
- Affiliation parameter search results are NOT paginated, as this approach typically returns a small number of results
curl https://api.ror.org/organizations?affiliation=Department%20of%20Civil%20and%20Industrial%20Engineering%2C%20University%20of%20Pisa%2C%20Largo%20Lucio%20Lazzarino%202%2C%20Pisa%2056126%2C%20Italy
curl https://api.ror.org/organizations?affiliation=UCL%20School%20of%20Slavonic%20and%20East%20European%20Studies
The response is a JSON object that contains an array of items with the following fields:
organization: ROR record for matched organizationsubstring: substring of the supplied string that generated this matchscore: matching confidence score, with values between 0 and 1 (inclusive)chosen: binary indicator of whether the score is high enough to consider the organization correctly matchedmatching_type: type of matching algorithm applied in this case, possible values:PHRASE: the entire phrase matched to a variant of the organization's nameCOMMON TERMS: the matching was done by comparing the words separatelyFUZZY: the matching was done by fuzzy-comparing the words separatelyHEURISTICS: "University of X" was matched to "X University"ACRONYM: matched by acronymEXACT: exact match of the entered string in name, aliases, labels or acronyms fields
Is it a match?
When using affiliation matching, look for results with
"chosen": trueif you want a simple approach to choosing the best match. When there's no result with"chosen": trueit can mean either that there are either no particularly good matches or that there are several good matches, but no clear winner. If there is no result with"chosen": true, some additional review (either by humans or machines) is almost always needed.
{
"items" : [
{
"chosen" : true,
"matching_type" : "COMMON TERMS",
"organization" : {
"acronyms" : [
"UniPi"
],
"addresses" : [
{
"city" : "Pisa",
"country_geonames_id" : 3175395,
"geonames_city" : {
"city" : "Pisa",
"geonames_admin1" : {
"ascii_name" : "Tuscany",
"code" : "IT.16",
"id" : 3165361,
"name" : "Tuscany"
},
"geonames_admin2" : {
"ascii_name" : "Province of Pisa",
"code" : "IT.16.PI",
"id" : 3170646,
"name" : "Province of Pisa"
},
"id" : 3170647,
"license" : {
"attribution" : "Data from geonames.org under a CC-BY 3.0 license",
"license" : "http://creativecommons.org/licenses/by/3.0/"
},
"nuts_level1" : {
"code" : "ITI",
"name" : "CENTRO (IT)"
},
"nuts_level2" : {
"code" : "ITI1",
"name" : "Toscana"
},
"nuts_level3" : {
"code" : "ITI17",
"name" : "Pisa"
}
},
"lat" : 43.716429,
"line" : null,
"lng" : 10.398687,
"postcode" : null,
"primary" : false,
"state" : "Toscana",
"state_code" : "IT-52"
}
],
"aliases" : [],
"country" : {
"country_code" : "IT",
"country_name" : "Italy"
},
"email_address" : "",
"established" : 1343,
"external_ids" : {
"FundRef" : {
"all" : [
"501100007514"
],
"preferred" : null
},
"GRID" : {
"all" : "grid.5395.a",
"preferred" : "grid.5395.a"
},
"ISNI" : {
"all" : [
"0000 0004 1757 3729"
],
"preferred" : null
},
"OrgRef" : {
"all" : [
"453158"
],
"preferred" : null
},
"Wikidata" : {
"all" : [
"Q645663"
],
"preferred" : null
}
},
"id" : "https://ror.org/03ad39j10",
"ip_addresses" : [],
"labels" : [
{
"iso639" : "it",
"label" : "Università di Pisa"
},
{
"iso639" : "de",
"label" : "Universität Pisa"
},
{
"iso639" : "fr",
"label" : "Université de Pise"
}
],
"links" : [
"http://www.unipi.it/"
],
"name" : "University of Pisa",
"relationships" : [
{
"id" : "https://ror.org/00mc91w09",
"label" : "Ospedale Cisanello",
"type" : "Related"
}
],
"status" : "active",
"types" : [
"Education"
],
"wikipedia_url" : "http://en.wikipedia.org/wiki/University_of_Pisa"
},
"score" : 1,
"substring" : "Department of Civil and Industrial Engineering University of Pisa Largo Lucio Lazzarino 2 Pisa Italy"
},
{
"chosen" : false,
"matching_type" : "COMMON TERMS",
"organization" : {
"acronyms" : [],
"addresses" : [
{
"city" : "Pisa",
"country_geonames_id" : 3175395,
"geonames_city" : {
"city" : "Pisa",
"geonames_admin1" : {
"ascii_name" : "Tuscany",
"code" : "IT.16",
"id" : 3165361,
"name" : "Tuscany"
},
"geonames_admin2" : {
"ascii_name" : "Pisa",
"code" : "IT.16.PI",
"id" : 3170646,
"name" : "Pisa"
},
"id" : 3170647,
"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" : 43.70853,
"line" : null,
"lng" : 10.4036,
"postcode" : null,
"primary" : false,
"state" : null,
"state_code" : null
}
],
"aliases" : [],
"country" : {
"country_code" : "IT",
"country_name" : "Italy"
},
"email_address" : null,
"established" : null,
"external_ids" : {
"GRID" : {
"all" : "grid.144189.1",
"preferred" : "grid.144189.1"
},
"ISNI" : {
"all" : [
"0000 0004 1756 8209"
],
"preferred" : null
}
},
"id" : "https://ror.org/05xrcj819",
"ip_addresses" : [],
"labels" : [
{
"iso639" : "en",
"label" : "University Hospital of Pisa"
}
],
"links" : [
"http://www.ao-pisa.toscana.it/"
],
"name" : "Azienda Ospedaliera Universitaria Pisana",
"relationships" : [
{
"id" : "https://ror.org/00mc91w09",
"label" : "Ospedale Cisanello",
"type" : "Child"
},
{
"id" : "https://ror.org/04069k268",
"label" : "ERN ReCONNET",
"type" : "Related"
}
],
"status" : "active",
"types" : [
"Healthcare"
],
"wikipedia_url" : ""
},
"score" : 0.8,
"substring" : "University of Pisa"
},
{
"chosen" : false,
"matching_type" : "FUZZY",
"organization" : {
"acronyms" : [],
"addresses" : [
{
"city" : "Rome",
"country_geonames_id" : 3175395,
"geonames_city" : {
"city" : "Rome",
"geonames_admin1" : {
"ascii_name" : "Latium",
"code" : "IT.07",
"id" : 3174976,
"name" : "Latium"
},
"geonames_admin2" : {
"ascii_name" : "Citta metropolitana di Roma Capitale",
"code" : "IT.07.RM",
"id" : 3169069,
"name" : "Città metropolitana di Roma Capitale"
},
"id" : 3169070,
"license" : {
"attribution" : "Data from geonames.org under a CC-BY 3.0 license",
"license" : "http://creativecommons.org/licenses/by/3.0/"
},
"nuts_level1" : {
"code" : "ITI",
"name" : "CENTRO (IT)"
},
"nuts_level2" : {
"code" : "ITI4",
"name" : "Lazio"
},
"nuts_level3" : {
"code" : "ITI43",
"name" : "Roma"
}
},
"lat" : 41.899923,
"line" : null,
"lng" : 12.458225,
"postcode" : null,
"primary" : false,
"state" : null,
"state_code" : null
}
],
"aliases" : [
"Urbaniana"
],
"country" : {
"country_code" : "IT",
"country_name" : "Italy"
},
"email_address" : null,
"established" : 1627,
"external_ids" : {
"GRID" : {
"all" : "grid.449323.b",
"preferred" : "grid.449323.b"
},
"ISNI" : {
"all" : [
"0000 0004 1797 7432"
],
"preferred" : null
},
"OrgRef" : {
"all" : [
"7922067"
],
"preferred" : null
},
"Wikidata" : {
"all" : [
"Q2032536"
],
"preferred" : null
}
},
"id" : "https://ror.org/01yjpt684",
"ip_addresses" : [],
"labels" : [
{
"iso639" : "de",
"label" : "Päpstliche Universität Urbaniana"
},
{
"iso639" : "fr",
"label" : "Université pontificale urbaniana"
},
{
"iso639" : "it",
"label" : "Pontificia Università Urbaniana"
}
],
"links" : [
"http://www.urbaniana.edu/"
],
"name" : "Pontifical Urban University",
"relationships" : [],
"status" : "active",
"types" : [
"Education"
],
"wikipedia_url" : "https://en.wikipedia.org/wiki/Pontifical_Urban_University"
},
"score" : 0.67,
"substring" : "University of Pisa"
},
{
"chosen" : false,
"matching_type" : "COMMON TERMS",
"organization" : {
"acronyms" : [],
"addresses" : [
{
"city" : "Rome",
"country_geonames_id" : 3175395,
"geonames_city" : {
"city" : "Rome",
"geonames_admin1" : {
"ascii_name" : "Lazio",
"code" : "IT.07",
"id" : 3174976,
"name" : "Lazio"
},
"geonames_admin2" : {
"ascii_name" : "Rome",
"code" : "IT.07.RM",
"id" : 3169069,
"name" : "Rome"
},
"id" : 3169070,
"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" : 41.89193,
"line" : null,
"lng" : 12.51133,
"postcode" : null,
"primary" : false,
"state" : null,
"state_code" : null
}
],
"aliases" : [],
"country" : {
"country_code" : "IT",
"country_name" : "Italy"
},
"email_address" : null,
"established" : 1982,
"external_ids" : {
"FundRef" : {
"all" : [
"100012783"
],
"preferred" : "100012783"
},
"GRID" : {
"all" : "grid.425554.7",
"preferred" : "grid.425554.7"
},
"ISNI" : {
"all" : [
"0000 0004 1773 7551"
],
"preferred" : null
}
},
"id" : "https://ror.org/050xp5d36",
"ip_addresses" : [],
"labels" : [
{
"iso639" : "en",
"label" : "Civil Protection Department"
}
],
"links" : [
"http://www.protezionecivile.gov.it/jcms/en/homepage.wp"
],
"name" : "Dipartimento della Protezione Civile",
"relationships" : [],
"status" : "active",
"types" : [
"Government"
],
"wikipedia_url" : ""
},
"score" : 0.58,
"substring" : "Department of Civil and Industrial Engineering"
},
{
"chosen" : false,
"matching_type" : "COMMON TERMS",
"organization" : {
"acronyms" : [],
"addresses" : [
{
"city" : "Pisa",
"country_geonames_id" : 3175395,
"geonames_city" : {
"city" : "Pisa",
"geonames_admin1" : {
"ascii_name" : "Tuscany",
"code" : "IT.16",
"id" : 3165361,
"name" : "Tuscany"
},
"geonames_admin2" : {
"ascii_name" : "Province of Pisa",
"code" : "IT.16.PI",
"id" : 3170646,
"name" : "Province of Pisa"
},
"id" : 3170647,
"license" : {
"attribution" : "Data from geonames.org under a CC-BY 3.0 license",
"license" : "http://creativecommons.org/licenses/by/3.0/"
},
"nuts_level1" : {
"code" : "ITI",
"name" : "CENTRO (IT)"
},
"nuts_level2" : {
"code" : "ITI1",
"name" : "Toscana"
},
"nuts_level3" : {
"code" : "ITI17",
"name" : "Pisa"
}
},
"lat" : 43.721529,
"line" : null,
"lng" : 10.40824,
"postcode" : null,
"primary" : false,
"state" : null,
"state_code" : null
}
],
"aliases" : [
"Istituto Nazionale di Fisica Nucleare Sezione di Pisa"
],
"country" : {
"country_code" : "IT",
"country_name" : "Italy"
},
"email_address" : null,
"established" : null,
"external_ids" : {
"GRID" : {
"all" : "grid.470216.6",
"preferred" : "grid.470216.6"
},
"Wikidata" : {
"all" : [
"Q30265297"
],
"preferred" : null
}
},
"id" : "https://ror.org/05symbg58",
"ip_addresses" : [],
"labels" : [],
"links" : [
"http://www.pi.infn.it/"
],
"name" : "INFN Sezione di Pisa",
"relationships" : [
{
"id" : "https://ror.org/005ta0471",
"label" : "National Institute for Nuclear Physics",
"type" : "Parent"
},
{
"id" : "https://ror.org/00x27da85",
"label" : "University of Perugia",
"type" : "Parent"
}
],
"status" : "active",
"types" : [
"Facility"
],
"wikipedia_url" : ""
},
"score" : 0.55,
"substring" : "Department of Civil and Industrial Engineering University of Pisa Largo Lucio Lazzarino 2 Pisa Italy"
}
],
"number_of_results" : 5
}
No paging or filtering for affiliation searches
The affiliation parameter does not need paging and does not accept filters. When filter syntax is added to the end of an affiliation search, the terms will be treated as part of the affiliation search. All results will be returned, not just the first 20.
Advanced search
Complete API advanced search guide
See our API advanced search guide for complete documentation and examples.
Allows searching all ROR record fields. Complex queries using field names, wildcards, boolean operators, etc can be constructed using Elastic Search query string syntax. Uses the format https://api.ror.org/organizations?query.advanced=<field name>:<search term>. Advanced searches return the first 20 results and can be filtered.
- The value of the query.advanced parameter must be URL-encoded
- Elasticsearch reserved characters such as &, (), / and : must be URL-encoded and escaped using a URL-encoded \ character. See Special characters below for more details.
curl 'https://api.ror.org/organizations?query.advanced=name:Harvard%20University'
Paging
The ROR API returns a maximum of 20 results per page for query and advanced query searches, beginning at page 1. If metadata.number_of_results is greater than 20, retrieve subsequent records using the format https://api.ror.org/organizations?page=<page number>
Pagination limited to 500 pages
Elastic Search has an inherent upper limit of 10,000 results, which means that it is currently not possible to retrieve pages beyond page 500. If you need to use the entire ROR dataset in your application, please download the data dump If you send a request for a page beyond 500, you will receive a 200 status, but an error response like
{"errors":["page '5144' outside of range 1-500”]}
curl https://api.ror.org/organizations?page=2
To determine how many pages you will need to retrieve in order to obtain your entire result set, check metadata.number_of_results and divide by 20. Regardless of which page you are on, metadata.number_of_results indicates the total number of results returned by your request or query.
No paging with affiliation searching
Affiliation searches return all results, not just the first 20, so results do not need to be paged.
Filtering
ROR API results for query and advanced query searches can be filtered by organization type, country code, or country name using the filter parameter with types, country.country_code, country.country_name or status
- Uses the format
https://api.ror.org/organizations?filter=<filter>:<value>. - Country codes are those in the ISO 3166 alpha-2 list.
Available organization types:
- Education
- Healthcare
- Company
- Archive
- Nonprofit
- Government
- Facility
- Other
Available statuses:
- active
- inactive
- withdrawn
curl https://api.ror.org/organizations?filter=types:Facility
curl https://api.ror.org/organizations?filter=country.country_code:GB
curl https://api.ror.org/organizations?filter=country.country_name:France
curl https://api.ror.org/organizations?filter=status:inactive
You can combine multiple filters in a single request.
curl https://api.ror.org/organizations?filter=types:Facility,country.country_code:GB
You can add filters to query parameter searches.
curl https://api.ror.org/organizations?query=bath&filter=types:Facility,country.country_code:GB
You can add filters to advanced query parameter searches.
curl https://api.ror.org/organizations?query.advanced=name:Harvard%20University&filter=types:Education
No filtering with affiliation searching
The affiliation parameter does not accept filters. When filter syntax is added to the end of an affiliation search, the terms will be treated as part of the affiliation search.
Special characters
Some organization names contain characters like &, (), : and /, which have special meaning in URI syntax, Elasticsearch syntax or both. To avoid error responses or special characters being interpreted as part of a complex Elasticsearch query:
- URL-encode query parameter values
- Escape Elasticsearch reserved characters
+ - = && || > < ! ( ) { } [ ] ^ " ~ * ? : \ /with a URL-encoded \ character.
Example queries for organization names with special characters:
Harvard University/MGH
curl https://api.ror.org/organizations?query=Harvard%20University%5C%2FMGH
Franklin & Marshall College
Rolls-Royce (United Kingdom)
https://api.ror.org/organizations?query=Rolls%5C-Royce%20%5C%28United%20Kingdom%5C%29
curl https://api.ror.org/organizations?query=Franklin%20%26%20Marshall%20College
Search strings with spaces
Elasticsearch query string syntax will treat words separated by a space as separate parts of a query. It is therefore advisable to surround multi-word search terms of the ROR API with URL-encoded quotation marks.
Compare the following searches to see the difference quotation marks make for search strings with spaces:
https://api.ror.org/organizations?query=Bath+College (4587 results)
https://api.ror.org/organizations?query=%22Bath+College%22 (2 results)
The first query looks for both the term "Bath" and term "College" and produces many results because the term "College" appears in many organization names. The second query looks for the exact term "Bath College" and retrieves only records including that precise phrase.
Record status
As of 1 Dec, 2022 API search/list responses return only records with a status of active by default (see release notes).
Add the query parameter ?all_status to return records with all statuses (active, inactive, withdrawn). ?all_status can be used with ?query, ?query.advanced and ?affiliation searches.
See {ROR data structure](https://ror.readme.io/docs/ror-data-structure#status) for more information about record status.
Examples: ?all_status parameter
curl https://api.ror.org/organizations?all_status
curl https://api.ror.org/organizations?query=university&all_status
curl https://api.ror.org/organizations?query.advanced=name:Laboratory+of+Hydrology+and+Geochemistry&all_status
curl https://api.ror.org/organizations?affiliation=Laboratory+of+Hydrology+and+Geochemistry?all_status
Alternately, you can retrieve records with a given status using filters. Note that filters cannot be used with ?affiliation searches.
Examples: Filter by status
Multiple filters can be used, and filters can be combined with ?query and ?query.advanced searches. Filters cannot be used with ?affiliation searches. See filtering above for more information.
curl https://api.ror.org/organizations?filter=status:inactive
curl https://api.ror.org/organizations?filter=status:inactive,status:withdrawn
curl https://api.ror.org/organizations?filter=status:inactive,status:withdrawn,country.country_code:us
curl 'https://api.ror.org/organizations?query=International+Union&filter=status:inactive,status:withdrawn'
Requests or searches for a specific record by its exact ROR ID will return the record regardless of its status without need for the ?all_status parameter or filters.
Successor organizations
Records with a status of inactive or withdrawn may have one or more successor organizations listed in their relationships. Successor relationships indicate that another organization continues the work of an organization that has become inactive or has been withdrawn. If an organization simply changes its name, it will not receive a Successor; the existing ROR record for the organization will simply be modified with the new name in the name field and the previous name in the aliases field.
Depending on your use case you may wish to update references to inactive ROR records in your system(s) to the corresponding Successor organization(s).
See ROR data structure and ROR hierarchies and relationships for more information about relationships.
"relationships":[
{
"label":"Viavi Solutions (United States)",
"type":"Successor",
"id":"https://ror.org/059a9e323"
}
]
Updated about 1 month ago