Query parameter
ROR REST API v1
This page documents v1 of the ROR REST API. For v2 documentation of the ROR REST API, see https://ror.readme.io/v2/docs/api-query. You can also read more about ROR API versions and a summary of what's new in Schema 2.0 and Schema 2.1.
About the query parameter
The query parameter is a "quick search" of a limited number of fields in ROR records:name, aliases, labels, acronyms, and external_ids. The query parameter works best for the following purposes:
- Keyword-based searching for organization names
- Form field auto-suggests / typeaheads
- Searching for exact matches of an organization name
- Searching for external identifiers
We recommend using the query parameter to build ROR-powered typeaheads in forms that suggest organization names to users. The ROR Web search interface at https://ror.org/search also uses the query parameter.
Query parameter format
https://api.ror.org/v1/organizations?query=[value]
Formatting searches
All request strings must be URL-encoded.
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 bad results:
- Be sure to URL-encode all query parameter values.
- Escape any Elasticsearch reserved characters in the organization name with a URL-encoded backslash \ character. Reserved characters include
+ - = && || > < ! ( ) { } [ ] ^ " ~ * ? : \ /
Spaces and quotation marks
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.
Keyword searching
The query parameter can be used to search for relatively unique keywords in organization names.
Example
curl 'https://api.ror.org/v1/organizations?query=Bath' | json_pp
As with retrieving a list of ROR records, the response is a JSON object containing full records for the first 20 search results, but this search produces only 17 results, so only 17 items are returned.
{
"items" : [
{
"acronyms" : [],
"addresses" : [
{
"city" : "Bath",
"country_geonames_id" : null,
"geonames_city" : {
"city" : "Bath",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "GB.ENG",
"id" : null,
"name" : "England"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"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" : 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" : null
},
{
"acronyms" : [],
"addresses" : [
{
"city" : "Bath",
"country_geonames_id" : null,
"geonames_city" : {
"city" : "Bath",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "GB.ENG",
"id" : null,
"name" : "England"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"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" : 1892,
"external_ids" : {
"GRID" : {
"all" : "grid.468747.e",
"preferred" : "grid.468747.e"
},
"ISNI" : {
"all" : [
"0000 0004 6437 268X"
],
"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" : null,
"geonames_city" : {
"city" : "Bath",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "GB.ENG",
"id" : null,
"name" : "England"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"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" : [
"BMI Bath Clinic"
],
"country" : {
"country_code" : "GB",
"country_name" : "United Kingdom"
},
"email_address" : null,
"established" : 1983,
"external_ids" : {
"ISNI" : {
"all" : [
"0000 0004 0578 2443"
],
"preferred" : "0000 0004 0578 2443"
}
},
"id" : "https://ror.org/012mkjy35",
"ip_addresses" : [],
"labels" : [],
"links" : [
"https://www.circlehealthgroup.co.uk/hospitals/bath-clinic"
],
"name" : "Bath Clinic",
"relationships" : [],
"status" : "active",
"types" : [
"Healthcare"
],
"wikipedia_url" : null
},
{
"acronyms" : [],
"addresses" : [
{
"city" : "Bath",
"country_geonames_id" : null,
"geonames_city" : {
"city" : "Bath",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "US.ME",
"id" : null,
"name" : "Maine"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"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.91064,
"line" : null,
"lng" : -69.8206,
"postcode" : null,
"primary" : false,
"state" : null,
"state_code" : null
}
],
"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" : "Montreal",
"country_geonames_id" : null,
"geonames_city" : {
"city" : "Montreal",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "CA.QC",
"id" : null,
"name" : "Quebec"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"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.50884,
"line" : null,
"lng" : -73.58781,
"postcode" : null,
"primary" : false,
"state" : null,
"state_code" : null
}
],
"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" : null
},
{
"acronyms" : [],
"addresses" : [
{
"city" : "Columbus",
"country_geonames_id" : null,
"geonames_city" : {
"city" : "Columbus",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "US.OH",
"id" : null,
"name" : "Ohio"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"id" : 4509177,
"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" : 39.96118,
"line" : null,
"lng" : -82.99879,
"postcode" : null,
"primary" : false,
"state" : null,
"state_code" : null
}
],
"aliases" : [
"Bath and Body Works"
],
"country" : {
"country_code" : "US",
"country_name" : "United States"
},
"email_address" : null,
"established" : null,
"external_ids" : {
"Wikidata" : {
"all" : [
"Q810773"
],
"preferred" : "Q810773"
}
},
"id" : "https://ror.org/012ddk914",
"ip_addresses" : [],
"labels" : [
{
"iso639" : "en",
"label" : "Bath & Body Works"
}
],
"links" : [
"https://www.lb.com"
],
"name" : "Bath & Body Works (United States)",
"relationships" : [],
"status" : "active",
"types" : [
"Company"
],
"wikipedia_url" : "https://en.wikipedia.org/wiki/Bath_%26_Body_Works"
},
{
"acronyms" : [],
"addresses" : [
{
"city" : "Bath",
"country_geonames_id" : null,
"geonames_city" : {
"city" : "Bath",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "GB.ENG",
"id" : null,
"name" : "England"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"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"
},
"ISNI" : {
"all" : [
"0000 0001 2162 1699"
],
"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",
"Funder"
],
"wikipedia_url" : "http://en.wikipedia.org/wiki/University_of_Bath"
},
{
"acronyms" : [],
"addresses" : [
{
"city" : "Bath",
"country_geonames_id" : null,
"geonames_city" : {
"city" : "Bath",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "GB.ENG",
"id" : null,
"name" : "England"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"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" : [
"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"
},
"ISNI" : {
"all" : [
"0000 0001 2034 9451"
],
"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",
"Funder"
],
"wikipedia_url" : "http://en.wikipedia.org/wiki/Bath_Spa_University"
},
{
"acronyms" : [],
"addresses" : [
{
"city" : "Bath Beach",
"country_geonames_id" : null,
"geonames_city" : {
"city" : "Bath Beach",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "US.NY",
"id" : null,
"name" : "New York"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"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" : 40.60455,
"line" : null,
"lng" : -74.00431,
"postcode" : null,
"primary" : false,
"state" : null,
"state_code" : null
}
],
"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" : [
"BIRD"
],
"addresses" : [
{
"city" : "Bath",
"country_geonames_id" : null,
"geonames_city" : {
"city" : "Bath",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "GB.ENG",
"id" : null,
"name" : "England"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"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" : 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" : null
},
{
"acronyms" : [],
"addresses" : [
{
"city" : "Bath",
"country_geonames_id" : null,
"geonames_city" : {
"city" : "Bath",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "GB.ENG",
"id" : null,
"name" : "England"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"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" : [
"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" : [
"BBSP"
],
"addresses" : [
{
"city" : "Bristol",
"country_geonames_id" : null,
"geonames_city" : {
"city" : "Bristol",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "GB.ENG",
"id" : null,
"name" : "England"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"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" : null,
"name" : null
},
"nuts_level2" : {
"code" : null,
"name" : null
},
"nuts_level3" : {
"code" : null,
"name" : null
}
},
"lat" : 51.45523,
"line" : null,
"lng" : -2.59665,
"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" : [
"BSDR"
],
"addresses" : [
{
"city" : "Bath",
"country_geonames_id" : null,
"geonames_city" : {
"city" : "Bath",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "GB.ENG",
"id" : null,
"name" : "England"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"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" : 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" : null
},
{
"acronyms" : [
"BRLSI"
],
"addresses" : [
{
"city" : "Bath",
"country_geonames_id" : null,
"geonames_city" : {
"city" : "Bath",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "GB.ENG",
"id" : null,
"name" : "England"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"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" : [
"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"
},
"ISNI" : {
"all" : [
"0000 0004 5895 4392"
],
"preferred" : "0000 0004 5895 4392"
}
},
"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" : [],
"addresses" : [
{
"city" : "Bath",
"country_geonames_id" : null,
"geonames_city" : {
"city" : "Bath",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "GB.ENG",
"id" : null,
"name" : "England"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"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" : 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" : null,
"geonames_city" : {
"city" : "Bath",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "GB.ENG",
"id" : null,
"name" : "England"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"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" : [
"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
},
"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" : null,
"geonames_city" : {
"city" : "Bath",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "GB.ENG",
"id" : null,
"name" : "England"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"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" : 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" : null
}
],
"meta" : {
"countries" : [
{
"count" : 13,
"id" : "gb",
"title" : "United Kingdom"
},
{
"count" : 3,
"id" : "us",
"title" : "United States"
},
{
"count" : 1,
"id" : "ca",
"title" : "Canada"
}
],
"statuses" : [
{
"count" : 17,
"id" : "active",
"title" : "active"
}
],
"types" : [
{
"count" : 4,
"id" : "education",
"title" : "Education"
},
{
"count" : 4,
"id" : "healthcare",
"title" : "Healthcare"
},
{
"count" : 3,
"id" : "nonprofit",
"title" : "Nonprofit"
},
{
"count" : 2,
"id" : "company",
"title" : "Company"
},
{
"count" : 2,
"id" : "funder",
"title" : "Funder"
},
{
"count" : 1,
"id" : "archive",
"title" : "Archive"
},
{
"count" : 1,
"id" : "facility",
"title" : "Facility"
},
{
"count" : 1,
"id" : "government",
"title" : "Government"
},
{
"count" : 1,
"id" : "other",
"title" : "Other"
}
]
},
"number_of_results" : 17,
"time_taken" : 4
}
Remember that the query parameter does not search all fields
The query parameter searches only the four name-related fields (
name,acronyms,aliases, andlabels) and theexternal_idsfield. Results from keyword searches using the query parameter do not include values from location fields such ascountryandaddresses, for instance. To find location information or other additional data, use Filtering or the Advanced query parameter.
Exact string searching
Keyword searches can produce hundreds or thousands of results, especially when the string contains common terms in research organization names 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.
Example
Compare the following searches to see the difference quotation marks make for multiple-term search strings with spaces. The first example shows a search for Bath College.
curl 'https://api.ror.org/v1/organizations?query=Bath%20College' | json_pp
This search looks for both the term "Bath" and the term "College" and returns 4885 results because the term "College" appears in many organization names. A search on the single term "Bath" produces only 17 results, because it is a much less common term in organization names. The organization record for Bath College is the first of the 4885 results, but many factors can affect the order of results, so we strongly recommend against automatically selecting the first item in any list of search results.
{
"items" : [
{
"acronyms" : [],
"addresses" : [
{
"city" : "Bath",
"country_geonames_id" : null,
"geonames_city" : {
"city" : "Bath",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "GB.ENG",
"id" : null,
"name" : "England"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"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" : 1892,
"external_ids" : {
"GRID" : {
"all" : "grid.468747.e",
"preferred" : "grid.468747.e"
},
"ISNI" : {
"all" : [
"0000 0004 6437 268X"
],
"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" : null,
"geonames_city" : {
"city" : "Bath",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "GB.ENG",
"id" : null,
"name" : "England"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"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" : [
"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"
},
"ISNI" : {
"all" : [
"0000 0001 2034 9451"
],
"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",
"Funder"
],
"wikipedia_url" : "http://en.wikipedia.org/wiki/Bath_Spa_University"
},
{
"acronyms" : [],
"addresses" : [
{
"city" : "Bath",
"country_geonames_id" : null,
"geonames_city" : {
"city" : "Bath",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "GB.ENG",
"id" : null,
"name" : "England"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"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" : 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" : null
},
{
"acronyms" : [],
"addresses" : [
{
"city" : "Bath",
"country_geonames_id" : null,
"geonames_city" : {
"city" : "Bath",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "GB.ENG",
"id" : null,
"name" : "England"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"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" : [
"BMI Bath Clinic"
],
"country" : {
"country_code" : "GB",
"country_name" : "United Kingdom"
},
"email_address" : null,
"established" : 1983,
"external_ids" : {
"ISNI" : {
"all" : [
"0000 0004 0578 2443"
],
"preferred" : "0000 0004 0578 2443"
}
},
"id" : "https://ror.org/012mkjy35",
"ip_addresses" : [],
"labels" : [],
"links" : [
"https://www.circlehealthgroup.co.uk/hospitals/bath-clinic"
],
"name" : "Bath Clinic",
"relationships" : [],
"status" : "active",
"types" : [
"Healthcare"
],
"wikipedia_url" : null
},
{
"acronyms" : [],
"addresses" : [
{
"city" : "Montreal",
"country_geonames_id" : null,
"geonames_city" : {
"city" : "Montreal",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "CA.QC",
"id" : null,
"name" : "Quebec"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"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.50884,
"line" : null,
"lng" : -73.58781,
"postcode" : null,
"primary" : false,
"state" : null,
"state_code" : null
}
],
"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" : null
},
{
"acronyms" : [],
"addresses" : [
{
"city" : "Bath",
"country_geonames_id" : null,
"geonames_city" : {
"city" : "Bath",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "US.ME",
"id" : null,
"name" : "Maine"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"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.91064,
"line" : null,
"lng" : -69.8206,
"postcode" : null,
"primary" : false,
"state" : null,
"state_code" : null
}
],
"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" : null,
"geonames_city" : {
"city" : "Bath",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "GB.ENG",
"id" : null,
"name" : "England"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"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"
},
"ISNI" : {
"all" : [
"0000 0001 2162 1699"
],
"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",
"Funder"
],
"wikipedia_url" : "http://en.wikipedia.org/wiki/University_of_Bath"
},
{
"acronyms" : [],
"addresses" : [
{
"city" : "Columbus",
"country_geonames_id" : null,
"geonames_city" : {
"city" : "Columbus",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "US.OH",
"id" : null,
"name" : "Ohio"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"id" : 4509177,
"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" : 39.96118,
"line" : null,
"lng" : -82.99879,
"postcode" : null,
"primary" : false,
"state" : null,
"state_code" : null
}
],
"aliases" : [
"Bath and Body Works"
],
"country" : {
"country_code" : "US",
"country_name" : "United States"
},
"email_address" : null,
"established" : null,
"external_ids" : {
"Wikidata" : {
"all" : [
"Q810773"
],
"preferred" : "Q810773"
}
},
"id" : "https://ror.org/012ddk914",
"ip_addresses" : [],
"labels" : [
{
"iso639" : "en",
"label" : "Bath & Body Works"
}
],
"links" : [
"https://www.lb.com"
],
"name" : "Bath & Body Works (United States)",
"relationships" : [],
"status" : "active",
"types" : [
"Company"
],
"wikipedia_url" : "https://en.wikipedia.org/wiki/Bath_%26_Body_Works"
},
{
"acronyms" : [],
"addresses" : [
{
"city" : "Bath Beach",
"country_geonames_id" : null,
"geonames_city" : {
"city" : "Bath Beach",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "US.NY",
"id" : null,
"name" : "New York"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"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" : 40.60455,
"line" : null,
"lng" : -74.00431,
"postcode" : null,
"primary" : false,
"state" : null,
"state_code" : null
}
],
"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" : [
"BIRD"
],
"addresses" : [
{
"city" : "Bath",
"country_geonames_id" : null,
"geonames_city" : {
"city" : "Bath",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "GB.ENG",
"id" : null,
"name" : "England"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"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" : 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" : null
},
{
"acronyms" : [],
"addresses" : [
{
"city" : "Bath",
"country_geonames_id" : null,
"geonames_city" : {
"city" : "Bath",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "GB.ENG",
"id" : null,
"name" : "England"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"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" : [
"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" : [
"BBSP"
],
"addresses" : [
{
"city" : "Bristol",
"country_geonames_id" : null,
"geonames_city" : {
"city" : "Bristol",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "GB.ENG",
"id" : null,
"name" : "England"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"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" : null,
"name" : null
},
"nuts_level2" : {
"code" : null,
"name" : null
},
"nuts_level3" : {
"code" : null,
"name" : null
}
},
"lat" : 51.45523,
"line" : null,
"lng" : -2.59665,
"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" : [
"BSDR"
],
"addresses" : [
{
"city" : "Bath",
"country_geonames_id" : null,
"geonames_city" : {
"city" : "Bath",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "GB.ENG",
"id" : null,
"name" : "England"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"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" : 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" : null
},
{
"acronyms" : [
"BRLSI"
],
"addresses" : [
{
"city" : "Bath",
"country_geonames_id" : null,
"geonames_city" : {
"city" : "Bath",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "GB.ENG",
"id" : null,
"name" : "England"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"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" : [
"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"
},
"ISNI" : {
"all" : [
"0000 0004 5895 4392"
],
"preferred" : "0000 0004 5895 4392"
}
},
"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" : [],
"addresses" : [
{
"city" : "Bath",
"country_geonames_id" : null,
"geonames_city" : {
"city" : "Bath",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "GB.ENG",
"id" : null,
"name" : "England"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"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" : 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" : null,
"geonames_city" : {
"city" : "Bath",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "GB.ENG",
"id" : null,
"name" : "England"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"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" : [
"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
},
"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" : null,
"geonames_city" : {
"city" : "Bath",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "GB.ENG",
"id" : null,
"name" : "England"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"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" : 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" : null
},
{
"acronyms" : [],
"addresses" : [
{
"city" : "Higashiosaka",
"country_geonames_id" : null,
"geonames_city" : {
"city" : "Higashiosaka",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "JP.27",
"id" : null,
"name" : "Osaka"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"id" : 1862752,
"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" : 34.66667,
"line" : null,
"lng" : 135.58333,
"postcode" : null,
"primary" : false,
"state" : null,
"state_code" : null
}
],
"aliases" : [
"Higashiosaka Junior College"
],
"country" : {
"country_code" : "JP",
"country_name" : "Japan"
},
"email_address" : null,
"established" : 1965,
"external_ids" : {
"GRID" : {
"all" : "grid.443664.7",
"preferred" : "grid.443664.7"
},
"ISNI" : {
"all" : [
"0000 0004 0642 2167"
],
"preferred" : null
},
"Wikidata" : {
"all" : [
"Q11526509"
],
"preferred" : null
}
},
"id" : "https://ror.org/01n7wbg90",
"ip_addresses" : [],
"labels" : [
{
"iso639" : "ja",
"label" : "東大阪大学・東大阪大学短期大学部"
}
],
"links" : [
"http://www.higashiosaka.ac.jp/"
],
"name" : "Higashiosaka College & Higashiosaka Junior College",
"relationships" : [],
"status" : "active",
"types" : [
"Education"
],
"wikipedia_url" : "https://en.wikipedia.org/wiki/Higashiosaka_Junior_College"
},
{
"acronyms" : [
"FMP"
],
"addresses" : [
{
"city" : "Fuzhou",
"country_geonames_id" : null,
"geonames_city" : {
"city" : "Fuzhou",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "CN.FJ",
"id" : null,
"name" : "Fujian"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"id" : 1810821,
"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" : 26.06139,
"line" : null,
"lng" : 119.30611,
"postcode" : null,
"primary" : false,
"state" : null,
"state_code" : null
}
],
"aliases" : [
"Minjiang College IEN International College",
"闽江学院爱恩国际学院"
],
"country" : {
"country_code" : "CN",
"country_name" : "China"
},
"email_address" : null,
"established" : null,
"external_ids" : {
"ISNI" : {
"all" : [
"0000 0005 1471 2065"
],
"preferred" : "0000 0005 1471 2065"
}
},
"id" : "https://ror.org/02p34hm58",
"ip_addresses" : [],
"labels" : [
{
"iso639" : "zh",
"label" : "福州墨尔本理工职业学院"
}
],
"links" : [
"https://www.fmp.edu.cn"
],
"name" : "Fuzhou Melbourne Polytechnic",
"relationships" : [
{
"id" : "https://ror.org/00s7tkw17",
"label" : "Minjiang University",
"type" : "Parent"
},
{
"id" : "https://ror.org/04cq7wg91",
"label" : "Melbourne Polytechnic",
"type" : "Parent"
}
],
"status" : "active",
"types" : [
"Education"
],
"wikipedia_url" : null
},
{
"acronyms" : [],
"addresses" : [
{
"city" : "Washington",
"country_geonames_id" : null,
"geonames_city" : {
"city" : "Washington",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "US.DC",
"id" : null,
"name" : "District of Columbia"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"id" : 4140963,
"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" : 38.89511,
"line" : null,
"lng" : -77.03637,
"postcode" : null,
"primary" : false,
"state" : null,
"state_code" : null
}
],
"aliases" : [],
"country" : {
"country_code" : "US",
"country_name" : "United States"
},
"email_address" : null,
"established" : 1996,
"external_ids" : {
"GRID" : {
"all" : "grid.479285.5",
"preferred" : "grid.479285.5"
}
},
"id" : "https://ror.org/02ejxt329",
"ip_addresses" : [],
"labels" : [],
"links" : [
"https://www.collegesummit.org/"
],
"name" : "College Summit",
"relationships" : [],
"status" : "active",
"types" : [
"Nonprofit"
],
"wikipedia_url" : "https://en.wikipedia.org/wiki/College_Summit"
}
],
"meta" : {
"countries" : [
{
"count" : 2100,
"id" : "us",
"title" : "United States"
},
{
"count" : 417,
"id" : "in",
"title" : "India"
},
{
"count" : 361,
"id" : "jp",
"title" : "Japan"
},
{
"count" : 337,
"id" : "gb",
"title" : "United Kingdom"
},
{
"count" : 307,
"id" : "cn",
"title" : "China"
},
{
"count" : 165,
"id" : "ca",
"title" : "Canada"
},
{
"count" : 117,
"id" : "ph",
"title" : "Philippines"
},
{
"count" : 78,
"id" : "gh",
"title" : "Ghana"
},
{
"count" : 64,
"id" : "kr",
"title" : "South Korea"
},
{
"count" : 53,
"id" : "au",
"title" : "Australia"
}
],
"statuses" : [
{
"count" : 4885,
"id" : "active",
"title" : "active"
}
],
"types" : [
{
"count" : 4564,
"id" : "education",
"title" : "Education"
},
{
"count" : 475,
"id" : "funder",
"title" : "Funder"
},
{
"count" : 182,
"id" : "healthcare",
"title" : "Healthcare"
},
{
"count" : 65,
"id" : "nonprofit",
"title" : "Nonprofit"
},
{
"count" : 46,
"id" : "other",
"title" : "Other"
},
{
"count" : 17,
"id" : "facility",
"title" : "Facility"
},
{
"count" : 4,
"id" : "company",
"title" : "Company"
},
{
"count" : 4,
"id" : "government",
"title" : "Government"
},
{
"count" : 3,
"id" : "archive",
"title" : "Archive"
}
]
},
"number_of_results" : 4885,
"time_taken" : 10
}
Don't automatically choose the first result in a list
The first item is often but not always the best match or desired result for a given search of the ROR API. We advise against building tools that automatically select the first result in a list of records.
Searching for the exact term "Bath College" retrieves only records that contain that precise phrase in one of the four name-related fields searched by the query parameter: name, acronyms, aliases, and labels.
curl 'https://api.ror.org/v1/organizations?query=%22Bath%20College%22' | json_pp
The response returns 2 records: the record for Bath College and the record for Bath Spa University, which is also known as Bath College of Higher Education.
{
"items" : [
{
"acronyms" : [],
"addresses" : [
{
"city" : "Bath",
"country_geonames_id" : null,
"geonames_city" : {
"city" : "Bath",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "GB.ENG",
"id" : null,
"name" : "England"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"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" : 1892,
"external_ids" : {
"GRID" : {
"all" : "grid.468747.e",
"preferred" : "grid.468747.e"
},
"ISNI" : {
"all" : [
"0000 0004 6437 268X"
],
"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" : null,
"geonames_city" : {
"city" : "Bath",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "GB.ENG",
"id" : null,
"name" : "England"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"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" : [
"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"
},
"ISNI" : {
"all" : [
"0000 0001 2034 9451"
],
"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",
"Funder"
],
"wikipedia_url" : "http://en.wikipedia.org/wiki/Bath_Spa_University"
}
],
"meta" : {
"countries" : [
{
"count" : 2,
"id" : "gb",
"title" : "United Kingdom"
}
],
"statuses" : [
{
"count" : 2,
"id" : "active",
"title" : "active"
}
],
"types" : [
{
"count" : 2,
"id" : "education",
"title" : "Education"
},
{
"count" : 1,
"id" : "funder",
"title" : "Funder"
}
]
},
"number_of_results" : 2,
"time_taken" : 5
}
Example
Remember to URL-encode and if necessary escape special characters in multi-term search strings, as when searching for "Franklin & Marshall College". The single & character is not reserved in Elasticsearch and therefore is not escaped.
curl 'https://api.ror.org/v1/organizations?query=%22Franklin%20%26%20Marshall%20College%22' | json_pp
When the & is URL-encoded, the response returns the single record for Franklin & Marshall College. When the & is not URL-encoded, the response is an error.
{
"items" : [
{
"acronyms" : [
"F&M"
],
"addresses" : [
{
"city" : "Lancaster",
"country_geonames_id" : null,
"geonames_city" : {
"city" : "Lancaster",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "US.PA",
"id" : null,
"name" : "Pennsylvania"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"id" : 5197079,
"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" : 40.03788,
"line" : null,
"lng" : -76.30551,
"postcode" : null,
"primary" : false,
"state" : null,
"state_code" : null
}
],
"aliases" : [],
"country" : {
"country_code" : "US",
"country_name" : "United States"
},
"email_address" : null,
"established" : 1787,
"external_ids" : {
"FundRef" : {
"all" : [
"100012632"
],
"preferred" : "100012632"
},
"GRID" : {
"all" : "grid.256069.e",
"preferred" : "grid.256069.e"
},
"ISNI" : {
"all" : [
"0000 0001 2162 8305"
],
"preferred" : "0000 0001 2162 8305"
},
"Wikidata" : {
"all" : [
"Q664881"
],
"preferred" : null
}
},
"id" : "https://ror.org/04fp4ps48",
"ip_addresses" : [],
"labels" : [],
"links" : [
"https://www.fandm.edu"
],
"name" : "Franklin & Marshall College",
"relationships" : [],
"status" : "active",
"types" : [
"Education",
"Funder"
],
"wikipedia_url" : "https://en.wikipedia.org/wiki/Franklin_%26_Marshall_College"
}
],
"meta" : {
"countries" : [
{
"count" : 1,
"id" : "us",
"title" : "United States"
}
],
"statuses" : [
{
"count" : 1,
"id" : "active",
"title" : "active"
}
],
"types" : [
{
"count" : 1,
"id" : "education",
"title" : "Education"
},
{
"count" : 1,
"id" : "funder",
"title" : "Funder"
}
]
},
"number_of_results" : 1,
"time_taken" : 4
}
Searching for identifiers
The query parameter searches the external_ids field and so can be used to search for ROR records that match an external unique identifier. Use URL-encoded quotation marks before and after the identifier search string for best results. This search will work for all identifier schemes supported in the external_ids field, including FundRef (aka the Crossref Funder Registry), GRID, ISNI, and Wikidata.
Example
Search for a ROR record corresponding to the GRID ID for the U.S. Department of Energy.
curl 'https://api.ror.org/v1/organizations?query=%22grid.85084.31%22' | json_pp
The response returns a single record for the U.S. Department of Energy that contains the searched-for identifier in external_ids.
{
"items" : [
{
"acronyms" : [
"DOE"
],
"addresses" : [
{
"city" : "Washington",
"country_geonames_id" : null,
"geonames_city" : {
"city" : "Washington",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "US.DC",
"id" : null,
"name" : "District of Columbia"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"id" : 4140963,
"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" : 38.89511,
"line" : null,
"lng" : -77.03637,
"postcode" : null,
"primary" : false,
"state" : null,
"state_code" : null
}
],
"aliases" : [
"U.S. Department of Energy"
],
"country" : {
"country_code" : "US",
"country_name" : "United States"
},
"email_address" : null,
"established" : 1977,
"external_ids" : {
"FundRef" : {
"all" : [
"100000015"
],
"preferred" : "100000015"
},
"GRID" : {
"all" : "grid.85084.31",
"preferred" : "grid.85084.31"
},
"ISNI" : {
"all" : [
"0000 0001 2342 3717"
],
"preferred" : null
},
"Wikidata" : {
"all" : [
"Q217810",
"Q6422983"
],
"preferred" : "Q217810"
}
},
"id" : "https://ror.org/01bj3aw27",
"ip_addresses" : [],
"labels" : [
{
"iso639" : "es",
"label" : "Departamento de Energía de los Estados Unidos"
},
{
"iso639" : "fr",
"label" : "Département de l'Énergie des États-unis"
}
],
"links" : [
"https://www.energy.gov"
],
"name" : "United States Department of Energy",
"relationships" : [
{
"id" : "https://ror.org/03q1rgc19",
"label" : "Advanced Research Projects Agency - Energy",
"type" : "Child"
},
{
"id" : "https://ror.org/00qq8bd87",
"label" : "Consortium for the Advanced Simulation of Light Water Reactors",
"type" : "Child"
},
{
"id" : "https://ror.org/01ca2by25",
"label" : "Great Lakes Bioenergy Research Center",
"type" : "Child"
},
{
"id" : "https://ror.org/04d8cf622",
"label" : "International Partnership for the Hydrogen and Fuel Cell in the Economy",
"type" : "Child"
},
{
"id" : "https://ror.org/03ww55028",
"label" : "Joint BioEnergy Institute",
"type" : "Child"
},
{
"id" : "https://ror.org/03sk1we31",
"label" : "National Nuclear Security Administration",
"type" : "Child"
},
{
"id" : "https://ror.org/037k8mg80",
"label" : "Nevada National Security Site",
"type" : "Child"
},
{
"id" : "https://ror.org/05hsv7e61",
"label" : "Office of Economic Impact and Diversity",
"type" : "Child"
},
{
"id" : "https://ror.org/02xznz413",
"label" : "Office of Energy Efficiency and Renewable Energy",
"type" : "Child"
},
{
"id" : "https://ror.org/00km40770",
"label" : "Office of Environmental Management",
"type" : "Child"
},
{
"id" : "https://ror.org/01c9ay627",
"label" : "Office of Environmental Protection, Sustainability Support and Corporate Safety Analysis",
"type" : "Child"
},
{
"id" : "https://ror.org/03ery9d53",
"label" : "Office of Fossil Energy",
"type" : "Child"
},
{
"id" : "https://ror.org/04nnxen11",
"label" : "Office of Inspector General",
"type" : "Child"
},
{
"id" : "https://ror.org/02z1qvq09",
"label" : "Office of Intelligence and Counterintelligence",
"type" : "Child"
},
{
"id" : "https://ror.org/05ek3m339",
"label" : "Office of International Affairs",
"type" : "Child"
},
{
"id" : "https://ror.org/03jf3w726",
"label" : "Office of Legacy Management",
"type" : "Child"
},
{
"id" : "https://ror.org/02ah1da87",
"label" : "Office of Management",
"type" : "Child"
},
{
"id" : "https://ror.org/05tj7dm33",
"label" : "Office of Nuclear Energy",
"type" : "Child"
},
{
"id" : "https://ror.org/00mmn6b08",
"label" : "Office of Science",
"type" : "Child"
},
{
"id" : "https://ror.org/04s778r16",
"label" : "Office of Space and Defense Power Systems",
"type" : "Child"
},
{
"id" : "https://ror.org/03eecgp81",
"label" : "Office of Under Secretary of Energy for Science",
"type" : "Child"
},
{
"id" : "https://ror.org/0054t4769",
"label" : "Office of the General Counsel",
"type" : "Child"
},
{
"id" : "https://ror.org/05hhm9a98",
"label" : "Savannah River Operations Office",
"type" : "Child"
},
{
"id" : "https://ror.org/01h04ms65",
"label" : "U.S. Energy Information Administration",
"type" : "Child"
},
{
"id" : "https://ror.org/048g3cy84",
"label" : "Vera C. Rubin Observatory",
"type" : "Child"
},
{
"id" : "https://ror.org/03e7mhc87",
"label" : "Kansas City National Security Campus",
"type" : "Child"
},
{
"id" : "https://ror.org/01t14bp54",
"label" : "Environmental System Science Data Infrastructure for a Virtual Ecosystem",
"type" : "Child"
},
{
"id" : "https://ror.org/00hvbwp12",
"label" : "Office of the Chief Information Officer",
"type" : "Child"
},
{
"id" : "https://ror.org/00htph268",
"label" : "Office of Under Secretary for Science and Innovation",
"type" : "Child"
},
{
"id" : "https://ror.org/02vg64e60",
"label" : "Office of Technology Transitions",
"type" : "Child"
},
{
"id" : "https://ror.org/028rfb880",
"label" : "Office of Secretary of Energy",
"type" : "Child"
},
{
"id" : "https://ror.org/00mw1dx44",
"label" : "Office of Public Affairs",
"type" : "Child"
},
{
"id" : "https://ror.org/05p9bjd64",
"label" : "Office of Policy",
"type" : "Child"
},
{
"id" : "https://ror.org/02bhbx726",
"label" : "Office of Indian Energy Policy and Programs",
"type" : "Child"
},
{
"id" : "https://ror.org/037897814",
"label" : "Office of Fossil Energy and Carbon Management",
"type" : "Child"
},
{
"id" : "https://ror.org/04csf5r20",
"label" : "Office of Environment, Health, Safety and Security",
"type" : "Child"
},
{
"id" : "https://ror.org/035fxjt55",
"label" : "Office of Enterprise Assessments",
"type" : "Child"
},
{
"id" : "https://ror.org/035sc8895",
"label" : "Office of State and Community Energy Programs",
"type" : "Child"
},
{
"id" : "https://ror.org/01zprx076",
"label" : "Office of Federal Energy Management Programs",
"type" : "Child"
},
{
"id" : "https://ror.org/00n4kg172",
"label" : "Grid Deployment Office",
"type" : "Child"
},
{
"id" : "https://ror.org/02y6dp041",
"label" : "Office of Electricity",
"type" : "Child"
},
{
"id" : "https://ror.org/041g4v832",
"label" : "Office of Cybersecurity, Energy Security, and Emergency Response",
"type" : "Child"
},
{
"id" : "https://ror.org/05cpnza27",
"label" : "Office of Congressional and Intergovernmental Affairs",
"type" : "Child"
},
{
"id" : "https://ror.org/040vxhp34",
"label" : "Oak Ridge Institute for Science and Education",
"type" : "Child"
},
{
"id" : "https://ror.org/00536t873",
"label" : "Artificial Intelligence & Technology Office",
"type" : "Child"
},
{
"id" : "https://ror.org/04rp4zh16",
"label" : "Office of Clean Energy Demonstrations",
"type" : "Child"
},
{
"id" : "https://ror.org/02rcrvv70",
"label" : "Government of the United States of America",
"type" : "Parent"
}
],
"status" : "active",
"types" : [
"Government",
"Funder"
],
"wikipedia_url" : "http://en.wikipedia.org/wiki/United_States_Department_of_Energy"
}
],
"meta" : {
"countries" : [
{
"count" : 1,
"id" : "us",
"title" : "United States"
}
],
"statuses" : [
{
"count" : 1,
"id" : "active",
"title" : "active"
}
],
"types" : [
{
"count" : 1,
"id" : "funder",
"title" : "Funder"
},
{
"count" : 1,
"id" : "government",
"title" : "Government"
}
]
},
"number_of_results" : 1,
"time_taken" : 8
}
Paging and filtering
Search results from the query parameter can be paged and filtered. The all_status parameter can also be appended to query parameter searches in order to retrieve inactive and withdrawn records as well as active records.
Example
curl 'https://api.ror.org/v1/organizations?query=Harvard&page=2&all_status' | json_pp
The response returns the second page of results of a keyword search for "Harvard" that includes records of all status types.
{
"items" : [
{
"acronyms" : [
"HCA"
],
"addresses" : [
{
"city" : "Sydney",
"country_geonames_id" : null,
"geonames_city" : {
"city" : "Sydney",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "AU.NSW",
"id" : null,
"name" : "New South Wales"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"id" : 2147714,
"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" : -33.86785,
"line" : null,
"lng" : 151.20732,
"postcode" : null,
"primary" : false,
"state" : null,
"state_code" : null
}
],
"aliases" : [],
"country" : {
"country_code" : "AU",
"country_name" : "Australia"
},
"email_address" : null,
"established" : null,
"external_ids" : {
"FundRef" : {
"all" : [
"501100001206"
],
"preferred" : null
},
"GRID" : {
"all" : "grid.467421.2",
"preferred" : "grid.467421.2"
},
"ISNI" : {
"all" : [
"0000 0004 5900 2457"
],
"preferred" : "0000 0004 5900 2457"
}
},
"id" : "https://ror.org/04ms16277",
"ip_addresses" : [],
"labels" : [],
"links" : [
"http://www.harvardclub.org.au/"
],
"name" : "Harvard Club of Australia",
"relationships" : [],
"status" : "active",
"types" : [
"Other",
"Funder"
],
"wikipedia_url" : null
},
{
"acronyms" : [
"HAEMR"
],
"addresses" : [
{
"city" : "Boston",
"country_geonames_id" : null,
"geonames_city" : {
"city" : "Boston",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "US.MA",
"id" : null,
"name" : "Massachusetts"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"id" : 4930956,
"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.35843,
"line" : null,
"lng" : -71.05977,
"postcode" : null,
"primary" : false,
"state" : null,
"state_code" : null
}
],
"aliases" : [],
"country" : {
"country_code" : "US",
"country_name" : "United States"
},
"email_address" : null,
"established" : null,
"external_ids" : {
"GRID" : {
"all" : "grid.418411.9",
"preferred" : "grid.418411.9"
}
},
"id" : "https://ror.org/005m2at17",
"ip_addresses" : [],
"labels" : [],
"links" : [
"http://www.massgeneral.org/emergencymedicine/education/residency.aspx?id=84&display=overview"
],
"name" : "Harvard Affiliated Emergency Medicine Residency",
"relationships" : [
{
"id" : "https://ror.org/04b6nzv94",
"label" : "Brigham and Women's Hospital",
"type" : "Parent"
},
{
"id" : "https://ror.org/002pd6e78",
"label" : "Massachusetts General Hospital",
"type" : "Parent"
}
],
"status" : "active",
"types" : [
"Other"
],
"wikipedia_url" : null
},
{
"acronyms" : [
"DF/HCC"
],
"addresses" : [
{
"city" : "Boston",
"country_geonames_id" : null,
"geonames_city" : {
"city" : "Boston",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "US.MA",
"id" : null,
"name" : "Massachusetts"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"id" : 4930956,
"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.35843,
"line" : null,
"lng" : -71.05977,
"postcode" : null,
"primary" : false,
"state" : null,
"state_code" : null
}
],
"aliases" : [],
"country" : {
"country_code" : "US",
"country_name" : "United States"
},
"email_address" : null,
"established" : 1973,
"external_ids" : {
"FundRef" : {
"all" : [
"100008126"
],
"preferred" : "100008126"
},
"GRID" : {
"all" : "grid.477947.e",
"preferred" : "grid.477947.e"
},
"ISNI" : {
"all" : [
"0000 0004 5902 1762"
],
"preferred" : null
},
"Wikidata" : {
"all" : [
"Q30270475"
],
"preferred" : "Q30270475"
}
},
"id" : "https://ror.org/03pvyf116",
"ip_addresses" : [],
"labels" : [],
"links" : [
"https://www.dfhcc.harvard.edu"
],
"name" : "Dana-Farber/Harvard Cancer Center",
"relationships" : [
{
"id" : "https://ror.org/03vek6s52",
"label" : "Harvard University",
"type" : "Parent"
},
{
"id" : "https://ror.org/02jzgtq86",
"label" : "Dana-Farber Cancer Institute",
"type" : "Parent"
}
],
"status" : "active",
"types" : [
"Healthcare",
"Funder"
],
"wikipedia_url" : null
},
{
"acronyms" : [],
"addresses" : [
{
"city" : "Boston",
"country_geonames_id" : null,
"geonames_city" : {
"city" : "Boston",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "US.MA",
"id" : null,
"name" : "Massachusetts"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"id" : 4930956,
"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.35843,
"line" : null,
"lng" : -71.05977,
"postcode" : null,
"primary" : false,
"state" : null,
"state_code" : null
}
],
"aliases" : [
"Arnold Arboretum of Harvard University"
],
"country" : {
"country_code" : "US",
"country_name" : "United States"
},
"email_address" : null,
"established" : 1872,
"external_ids" : {
"FundRef" : {
"all" : [
"100009403"
],
"preferred" : "100009403"
},
"ISNI" : {
"all" : [
"0000 0001 2293 3096"
],
"preferred" : "0000 0001 2293 3096"
},
"Wikidata" : {
"all" : [
"Q568666"
],
"preferred" : "Q568666"
}
},
"id" : "https://ror.org/05xsxgs79",
"ip_addresses" : [],
"labels" : [],
"links" : [
"http://www.arboretum.harvard.edu/"
],
"name" : "Arnold Arboretum",
"relationships" : [
{
"id" : "https://ror.org/03vek6s52",
"label" : "Harvard University",
"type" : "Parent"
}
],
"status" : "active",
"types" : [
"Archive",
"Funder"
],
"wikipedia_url" : "https://en.wikipedia.org/wiki/Arnold_Arboretum"
},
{
"acronyms" : [
"CfA"
],
"addresses" : [
{
"city" : "Cambridge",
"country_geonames_id" : null,
"geonames_city" : {
"city" : "Cambridge",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "US.MA",
"id" : null,
"name" : "Massachusetts"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"id" : 4931972,
"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.3751,
"line" : null,
"lng" : -71.10561,
"postcode" : null,
"primary" : false,
"state" : null,
"state_code" : null
}
],
"aliases" : [
"Harvard–Smithsonian Center for Astrophysics"
],
"country" : {
"country_code" : "US",
"country_name" : "United States"
},
"email_address" : null,
"established" : 1973,
"external_ids" : {
"GRID" : {
"all" : "grid.455754.2",
"preferred" : "grid.455754.2"
},
"Wikidata" : {
"all" : [
"Q1133697"
],
"preferred" : null
}
},
"id" : "https://ror.org/03c3r2d17",
"ip_addresses" : [],
"labels" : [],
"links" : [
"https://pweb.cfa.harvard.edu/"
],
"name" : "Center for Astrophysics Harvard & Smithsonian",
"relationships" : [
{
"id" : "https://ror.org/01mcvy510",
"label" : "Harvard College Observatory",
"type" : "Child"
},
{
"id" : "https://ror.org/04mh52z70",
"label" : "Smithsonian Astrophysical Observatory",
"type" : "Child"
},
{
"id" : "https://ror.org/03vek6s52",
"label" : "Harvard University",
"type" : "Parent"
},
{
"id" : "https://ror.org/01pp8nd67",
"label" : "Smithsonian Institution",
"type" : "Parent"
}
],
"status" : "active",
"types" : [
"Education"
],
"wikipedia_url" : "https://en.wikipedia.org/wiki/Harvard%E2%80%93Smithsonian_Center_for_Astrophysics"
},
{
"acronyms" : [
"BHP"
],
"addresses" : [
{
"city" : "Gaborone",
"country_geonames_id" : null,
"geonames_city" : {
"city" : "Gaborone",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "BW.GA",
"id" : null,
"name" : "Gaborone"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"id" : 933773,
"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" : -24.65451,
"line" : null,
"lng" : 25.90859,
"postcode" : null,
"primary" : false,
"state" : null,
"state_code" : null
}
],
"aliases" : [],
"country" : {
"country_code" : "BW",
"country_name" : "Botswana"
},
"email_address" : null,
"established" : 1996,
"external_ids" : {
"GRID" : {
"all" : "grid.462829.3",
"preferred" : "grid.462829.3"
}
},
"id" : "https://ror.org/04rkbns44",
"ip_addresses" : [],
"labels" : [],
"links" : [
"https://www.bhp.org.bw"
],
"name" : "Botswana Harvard AIDS Institute Partnership",
"relationships" : [
{
"id" : "https://ror.org/03vek6s52",
"label" : "Harvard University",
"type" : "Related"
}
],
"status" : "active",
"types" : [
"Other"
],
"wikipedia_url" : null
},
{
"acronyms" : [],
"addresses" : [
{
"city" : "Cambridge",
"country_geonames_id" : null,
"geonames_city" : {
"city" : "Cambridge",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "US.MA",
"id" : null,
"name" : "Massachusetts"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"id" : 4931972,
"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.3751,
"line" : null,
"lng" : -71.10561,
"postcode" : null,
"primary" : false,
"state" : null,
"state_code" : null
}
],
"aliases" : [
"Broad Institute of MIT and Harvard",
"Eli and Edythe L. Broad Institute of MIT and Harvard"
],
"country" : {
"country_code" : "US",
"country_name" : "United States"
},
"email_address" : null,
"established" : 2004,
"external_ids" : {
"FundRef" : {
"all" : [
"100013114"
],
"preferred" : "100013114"
},
"GRID" : {
"all" : "grid.66859.34",
"preferred" : "grid.66859.34"
},
"ISNI" : {
"all" : [
"0000 0004 0546 1623"
],
"preferred" : "0000 0004 0546 1623"
},
"Wikidata" : {
"all" : [
"Q4971893"
],
"preferred" : null
}
},
"id" : "https://ror.org/05a0ya142",
"ip_addresses" : [],
"labels" : [
{
"iso639" : "es",
"label" : "El Instituto Broad"
}
],
"links" : [
"http://www.broadinstitute.org/"
],
"name" : "Broad Institute",
"relationships" : [
{
"id" : "https://ror.org/01tm9b530",
"label" : "Stanley Center for Psychiatric Research",
"type" : "Child"
},
{
"id" : "https://ror.org/04drvxt59",
"label" : "Beth Israel Deaconess Medical Center",
"type" : "Related"
},
{
"id" : "https://ror.org/00dvg7y05",
"label" : "Boston Children's Hospital",
"type" : "Related"
},
{
"id" : "https://ror.org/04b6nzv94",
"label" : "Brigham and Women's Hospital",
"type" : "Related"
},
{
"id" : "https://ror.org/03vek6s52",
"label" : "Harvard University",
"type" : "Related"
},
{
"id" : "https://ror.org/002pd6e78",
"label" : "Massachusetts General Hospital",
"type" : "Related"
},
{
"id" : "https://ror.org/042nb2s44",
"label" : "Massachusetts Institute of Technology",
"type" : "Related"
}
],
"status" : "active",
"types" : [
"Nonprofit",
"Funder"
],
"wikipedia_url" : "http://en.wikipedia.org/wiki/Broad_Institute"
},
{
"acronyms" : [
"CUA"
],
"addresses" : [
{
"city" : "Cambridge",
"country_geonames_id" : null,
"geonames_city" : {
"city" : "Cambridge",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "US.MA",
"id" : null,
"name" : "Massachusetts"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"id" : 4931972,
"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.3751,
"line" : null,
"lng" : -71.10561,
"postcode" : null,
"primary" : false,
"state" : null,
"state_code" : null
}
],
"aliases" : [],
"country" : {
"country_code" : "US",
"country_name" : "United States"
},
"email_address" : null,
"established" : null,
"external_ids" : {
"FundRef" : {
"all" : [
"100019611"
],
"preferred" : "100019611"
},
"GRID" : {
"all" : "grid.509519.1",
"preferred" : "grid.509519.1"
}
},
"id" : "https://ror.org/053tmcn30",
"ip_addresses" : [],
"labels" : [],
"links" : [
"http://cuaweb.mit.edu/"
],
"name" : "MIT-Harvard Center for Ultracold Atoms",
"relationships" : [
{
"id" : "https://ror.org/03vek6s52",
"label" : "Harvard University",
"type" : "Parent"
},
{
"id" : "https://ror.org/042nb2s44",
"label" : "Massachusetts Institute of Technology",
"type" : "Parent"
}
],
"status" : "active",
"types" : [
"Facility",
"Funder"
],
"wikipedia_url" : null
},
{
"acronyms" : [],
"addresses" : [
{
"city" : "Cambridge",
"country_geonames_id" : null,
"geonames_city" : {
"city" : "Cambridge",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "US.MA",
"id" : null,
"name" : "Massachusetts"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"id" : 4931972,
"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.3751,
"line" : null,
"lng" : -71.10561,
"postcode" : null,
"primary" : false,
"state" : null,
"state_code" : null
}
],
"aliases" : [
"Phillip T. and Susan M. Ragon Institute",
"Ragon Institute of Massachusetts General Hospital, Massachusetts Institute of Technology and Harvard University"
],
"country" : {
"country_code" : "US",
"country_name" : "United States"
},
"email_address" : null,
"established" : 2009,
"external_ids" : {
"FundRef" : {
"all" : [
"100012802"
],
"preferred" : "100012802"
},
"GRID" : {
"all" : "grid.461656.6",
"preferred" : "grid.461656.6"
},
"ISNI" : {
"all" : [
"0000 0004 0489 3491"
],
"preferred" : null
},
"Wikidata" : {
"all" : [
"Q7185824"
],
"preferred" : null
}
},
"id" : "https://ror.org/053r20n13",
"ip_addresses" : [],
"labels" : [],
"links" : [
"http://ragoninstitute.org/"
],
"name" : "Ragon Institute of MGH, MIT and Harvard",
"relationships" : [
{
"id" : "https://ror.org/03vek6s52",
"label" : "Harvard University",
"type" : "Parent"
},
{
"id" : "https://ror.org/002pd6e78",
"label" : "Massachusetts General Hospital",
"type" : "Parent"
},
{
"id" : "https://ror.org/042nb2s44",
"label" : "Massachusetts Institute of Technology",
"type" : "Parent"
}
],
"status" : "active",
"types" : [
"Healthcare",
"Funder"
],
"wikipedia_url" : "https://en.wikipedia.org/wiki/Phillip_T._and_Susan_M._Ragon_Institute"
},
{
"acronyms" : [
"HST"
],
"addresses" : [
{
"city" : "Cambridge",
"country_geonames_id" : null,
"geonames_city" : {
"city" : "Cambridge",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "US.MA",
"id" : null,
"name" : "Massachusetts"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"id" : 4931972,
"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.3751,
"line" : null,
"lng" : -71.10561,
"postcode" : null,
"primary" : false,
"state" : null,
"state_code" : null
}
],
"aliases" : [],
"country" : {
"country_code" : "US",
"country_name" : "United States"
},
"email_address" : null,
"established" : 1970,
"external_ids" : {
"GRID" : {
"all" : "grid.413735.7",
"preferred" : "grid.413735.7"
},
"ISNI" : {
"all" : [
"0000 0004 0475 2760"
],
"preferred" : null
},
"Wikidata" : {
"all" : [
"Q5676651"
],
"preferred" : null
}
},
"id" : "https://ror.org/00jjeh629",
"ip_addresses" : [],
"labels" : [],
"links" : [
"http://hst.mit.edu/"
],
"name" : "Harvard–MIT Division of Health Sciences and Technology",
"relationships" : [
{
"id" : "https://ror.org/03vek6s52",
"label" : "Harvard University",
"type" : "Related"
},
{
"id" : "https://ror.org/042nb2s44",
"label" : "Massachusetts Institute of Technology",
"type" : "Related"
}
],
"status" : "active",
"types" : [
"Education"
],
"wikipedia_url" : "https://en.wikipedia.org/wiki/Harvard%E2%80%93MIT_Division_of_Health_Sciences_and_Technology"
},
{
"acronyms" : [
"MHAAM"
],
"addresses" : [
{
"city" : "Jena",
"country_geonames_id" : null,
"geonames_city" : {
"city" : "Jena",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "DE.TH",
"id" : null,
"name" : "Thuringia"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"id" : 2895044,
"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" : 50.92878,
"line" : null,
"lng" : 11.5899,
"postcode" : null,
"primary" : false,
"state" : null,
"state_code" : null
}
],
"aliases" : [],
"country" : {
"country_code" : "DE",
"country_name" : "Germany"
},
"email_address" : null,
"established" : 2017,
"external_ids" : {
"GRID" : {
"all" : "grid.511416.6",
"preferred" : "grid.511416.6"
},
"Wikidata" : {
"all" : [
"Q41498028"
],
"preferred" : null
}
},
"id" : "https://ror.org/00xj7pv34",
"ip_addresses" : [],
"labels" : [],
"links" : [
"https://www.archaeoscience.org/"
],
"name" : "Max Planck - Harvard Research Center for the Archaeoscience of the Ancient Mediterranean",
"relationships" : [],
"status" : "active",
"types" : [
"Facility"
],
"wikipedia_url" : "https://en.wikipedia.org/wiki/Max_Planck_Harvard_Research_Center_for_the_Archaeoscience_of_the_Ancient_Mediterranean"
}
],
"meta" : {
"countries" : [
{
"count" : 27,
"id" : "us",
"title" : "United States"
},
{
"count" : 2,
"id" : "de",
"title" : "Germany"
},
{
"count" : 1,
"id" : "au",
"title" : "Australia"
},
{
"count" : 1,
"id" : "bw",
"title" : "Botswana"
}
],
"statuses" : [
{
"count" : 29,
"id" : "active",
"title" : "active"
},
{
"count" : 1,
"id" : "inactive",
"title" : "inactive"
},
{
"count" : 1,
"id" : "withdrawn",
"title" : "withdrawn"
}
],
"types" : [
{
"count" : 15,
"id" : "funder",
"title" : "Funder"
},
{
"count" : 6,
"id" : "education",
"title" : "Education"
},
{
"count" : 6,
"id" : "facility",
"title" : "Facility"
},
{
"count" : 6,
"id" : "other",
"title" : "Other"
},
{
"count" : 5,
"id" : "healthcare",
"title" : "Healthcare"
},
{
"count" : 5,
"id" : "nonprofit",
"title" : "Nonprofit"
},
{
"count" : 2,
"id" : "company",
"title" : "Company"
},
{
"count" : 1,
"id" : "archive",
"title" : "Archive"
}
]
},
"number_of_results" : 31,
"time_taken" : 3
}
Example
curl 'https://api.ror.org/v1/organizations?query=Technology&filter=country.country_name:Jordan' | json_pp
The response returns a list of research organizations in the country of Jordan whose names include the keyword "Technology."
{
"items" : [
{
"acronyms" : [
"PSUT"
],
"addresses" : [
{
"city" : "Amman",
"country_geonames_id" : null,
"geonames_city" : {
"city" : "Amman",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "JO.AM",
"id" : null,
"name" : "Amman"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"id" : 250441,
"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" : 31.95522,
"line" : null,
"lng" : 35.94503,
"postcode" : null,
"primary" : false,
"state" : null,
"state_code" : null
}
],
"aliases" : [],
"country" : {
"country_code" : "JO",
"country_name" : "Jordan"
},
"email_address" : null,
"established" : 1991,
"external_ids" : {
"GRID" : {
"all" : "grid.29251.3d",
"preferred" : "grid.29251.3d"
},
"ISNI" : {
"all" : [
"0000 0004 0404 9637"
],
"preferred" : null
},
"Wikidata" : {
"all" : [
"Q3551722"
],
"preferred" : null
}
},
"id" : "https://ror.org/01jy46q10",
"ip_addresses" : [],
"labels" : [
{
"iso639" : "ar",
"label" : "جامعة الأميرة سمية للتكنولوجيا"
}
],
"links" : [
"https://www.psut.edu.jo"
],
"name" : "Princess Sumaya University for Technology",
"relationships" : [],
"status" : "active",
"types" : [
"Education"
],
"wikipedia_url" : "http://en.wikipedia.org/wiki/Princess_Sumaya_University_for_Technology"
},
{
"acronyms" : [
"JUST"
],
"addresses" : [
{
"city" : "Irbid",
"country_geonames_id" : null,
"geonames_city" : {
"city" : "Irbid",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "JO.IR",
"id" : null,
"name" : "Irbid"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"id" : 248946,
"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" : 32.55556,
"line" : null,
"lng" : 35.85,
"postcode" : null,
"primary" : false,
"state" : null,
"state_code" : null
}
],
"aliases" : [],
"country" : {
"country_code" : "JO",
"country_name" : "Jordan"
},
"email_address" : null,
"established" : 1986,
"external_ids" : {
"FundRef" : {
"all" : [
"501100004035",
"501100019004"
],
"preferred" : null
},
"GRID" : {
"all" : "grid.37553.37",
"preferred" : "grid.37553.37"
},
"ISNI" : {
"all" : [
"0000 0001 0097 5797"
],
"preferred" : null
},
"Wikidata" : {
"all" : [
"Q2919325"
],
"preferred" : null
}
},
"id" : "https://ror.org/03y8mtb59",
"ip_addresses" : [],
"labels" : [
{
"iso639" : "ar",
"label" : "جامعة العلوم والتكنولوجيا الأردنية"
}
],
"links" : [
"http://www.just.edu.jo/Pages/Default.aspx"
],
"name" : "Jordan University of Science and Technology",
"relationships" : [
{
"id" : "https://ror.org/02f2g4464",
"label" : "Jordan Research and Training Reactor",
"type" : "Child"
},
{
"id" : "https://ror.org/02f6hdc06",
"label" : "King Abdullah University Hospital",
"type" : "Related"
},
{
"id" : "https://ror.org/01fafm680",
"label" : "Specialty Hospital, Jordan",
"type" : "Related"
}
],
"status" : "active",
"types" : [
"Education",
"Funder"
],
"wikipedia_url" : "http://en.wikipedia.org/wiki/Jordan_University_of_Science_and_Technology"
},
{
"acronyms" : [
"HCST"
],
"addresses" : [
{
"city" : "Al Jubayhah",
"country_geonames_id" : null,
"geonames_city" : {
"city" : "Al Jubayhah",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "JO.AM",
"id" : null,
"name" : "Amman"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"id" : 250637,
"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" : 32.01071,
"line" : null,
"lng" : 35.89802,
"postcode" : null,
"primary" : false,
"state" : null,
"state_code" : null
}
],
"aliases" : [],
"country" : {
"country_code" : "JO",
"country_name" : "Jordan"
},
"email_address" : null,
"established" : 1987,
"external_ids" : {
"FundRef" : {
"all" : [
"501100010300"
],
"preferred" : "501100010300"
},
"GRID" : {
"all" : "grid.438384.0",
"preferred" : "grid.438384.0"
}
},
"id" : "https://ror.org/05bhjm183",
"ip_addresses" : [],
"labels" : [],
"links" : [
"http://hcst.gov.jo/"
],
"name" : "Higher Council for Science and Technology",
"relationships" : [
{
"id" : "https://ror.org/044wgz941",
"label" : "National Center for Research and Development",
"type" : "Child"
}
],
"status" : "active",
"types" : [
"Other",
"Funder"
],
"wikipedia_url" : null
}
],
"meta" : {
"countries" : [
{
"count" : 3,
"id" : "jo",
"title" : "Jordan"
}
],
"statuses" : [
{
"count" : 3,
"id" : "active",
"title" : "active"
}
],
"types" : [
{
"count" : 2,
"id" : "education",
"title" : "Education"
},
{
"count" : 2,
"id" : "funder",
"title" : "Funder"
},
{
"count" : 1,
"id" : "other",
"title" : "Other"
}
]
},
"number_of_results" : 3,
"time_taken" : 3
}
Example
curl 'https://api.ror.org/v1/organizations?query=Bath&filter=types:Facility,country.country_code:GB' | json_pp
The response returns a single research facility in Great Britain whose name contains the keyword "Bath".
{
"items" : [
{
"acronyms" : [],
"addresses" : [
{
"city" : "Bath",
"country_geonames_id" : null,
"geonames_city" : {
"city" : "Bath",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "GB.ENG",
"id" : null,
"name" : "England"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"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" : 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" : null
}
],
"meta" : {
"countries" : [
{
"count" : 1,
"id" : "gb",
"title" : "United Kingdom"
}
],
"statuses" : [
{
"count" : 1,
"id" : "active",
"title" : "active"
}
],
"types" : [
{
"count" : 1,
"id" : "facility",
"title" : "Facility"
}
]
},
"number_of_results" : 1,
"time_taken" : 3
}
Example
curl 'https://api.ror.org/v1/organizations?query=Osaka&filter=status:inactive,country.country_name:Japan' | json_pp
The response returns a list of inactive research organizations in Japan whose names contain the keyword "Osaka".
{
"items" : [
{
"acronyms" : [
"OCU"
],
"addresses" : [
{
"city" : "Osaka",
"country_geonames_id" : null,
"geonames_city" : {
"city" : "Osaka",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "JP.27",
"id" : null,
"name" : "Osaka"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"id" : 1853909,
"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" : 34.69379,
"line" : null,
"lng" : 135.50107,
"postcode" : null,
"primary" : false,
"state" : null,
"state_code" : null
}
],
"aliases" : [
"Ōsaka shiritsu daigaku"
],
"country" : {
"country_code" : "JP",
"country_name" : "Japan"
},
"email_address" : null,
"established" : 1880,
"external_ids" : {
"FundRef" : {
"all" : [
"100015062"
],
"preferred" : "100015062"
},
"GRID" : {
"all" : "grid.261445.0",
"preferred" : "grid.261445.0"
},
"ISNI" : {
"all" : [
"0000 0001 1009 6411"
],
"preferred" : null
},
"Wikidata" : {
"all" : [
"Q1143396"
],
"preferred" : null
}
},
"id" : "https://ror.org/02skfsw40",
"ip_addresses" : [],
"labels" : [
{
"iso639" : "ja",
"label" : "大阪市立大学"
}
],
"links" : [
"http://www.osaka-cu.ac.jp/en"
],
"name" : "Osaka City University",
"relationships" : [
{
"id" : "https://ror.org/05mxean80",
"label" : "Osaka City University Hospital",
"type" : "Related"
},
{
"id" : "https://ror.org/01hvx5h04",
"label" : "Osaka Metropolitan University",
"type" : "Successor"
}
],
"status" : "inactive",
"types" : [
"Education",
"Funder"
],
"wikipedia_url" : "http://en.wikipedia.org/wiki/Osaka_City_University"
},
{
"acronyms" : [
"OPU"
],
"addresses" : [
{
"city" : "Sakai",
"country_geonames_id" : null,
"geonames_city" : {
"city" : "Sakai",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "JP.27",
"id" : null,
"name" : "Osaka"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"id" : 1853195,
"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" : 34.58216,
"line" : null,
"lng" : 135.46653,
"postcode" : null,
"primary" : false,
"state" : null,
"state_code" : null
}
],
"aliases" : [
"Ōsaka furitsu daigaku"
],
"country" : {
"country_code" : "JP",
"country_name" : "Japan"
},
"email_address" : null,
"established" : 1883,
"external_ids" : {
"GRID" : {
"all" : "grid.261455.1",
"preferred" : "grid.261455.1"
},
"ISNI" : {
"all" : [
"0000 0001 0676 0594"
],
"preferred" : null
},
"Wikidata" : {
"all" : [
"Q290456"
],
"preferred" : null
}
},
"id" : "https://ror.org/02cf1je33",
"ip_addresses" : [],
"labels" : [
{
"iso639" : "ja",
"label" : "大阪府立大学"
}
],
"links" : [
"http://www.osakafu-u.ac.jp/english/"
],
"name" : "Osaka Prefecture University",
"relationships" : [
{
"id" : "https://ror.org/00vcb6036",
"label" : "Osaka Prefectural Medical Center",
"type" : "Related"
},
{
"id" : "https://ror.org/01hvx5h04",
"label" : "Osaka Metropolitan University",
"type" : "Successor"
}
],
"status" : "inactive",
"types" : [
"Education"
],
"wikipedia_url" : "http://en.wikipedia.org/wiki/Osaka_Prefecture_University"
},
{
"acronyms" : [],
"addresses" : [
{
"city" : "Osaka",
"country_geonames_id" : null,
"geonames_city" : {
"city" : "Osaka",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "JP.27",
"id" : null,
"name" : "Osaka"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"id" : 1853909,
"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" : 34.69379,
"line" : null,
"lng" : 135.50107,
"postcode" : null,
"primary" : false,
"state" : null,
"state_code" : null
}
],
"aliases" : [
"Osakameijojoshitankidaigaku"
],
"country" : {
"country_code" : "JP",
"country_name" : "Japan"
},
"email_address" : null,
"established" : 1985,
"external_ids" : {
"GRID" : {
"all" : "grid.471885.7",
"preferred" : "grid.471885.7"
},
"ISNI" : {
"all" : [
"0000 0000 9356 4825"
],
"preferred" : null
}
},
"id" : "https://ror.org/01kjjpm11",
"ip_addresses" : [],
"labels" : [
{
"iso639" : "ja",
"label" : "大阪明浄女子短期大学"
}
],
"links" : [
"http://www.meijo.ac.jp/about/education.html"
],
"name" : "Osaka Meijo Women's College",
"relationships" : [],
"status" : "inactive",
"types" : [
"Education"
],
"wikipedia_url" : null
},
{
"acronyms" : [],
"addresses" : [
{
"city" : "Osaka",
"country_geonames_id" : null,
"geonames_city" : {
"city" : "Osaka",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "JP.27",
"id" : null,
"name" : "Osaka"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"id" : 1853909,
"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" : 34.69379,
"line" : null,
"lng" : 135.50107,
"postcode" : null,
"primary" : false,
"state" : null,
"state_code" : null
}
],
"aliases" : [
"Ōsaka joshi tanki daigaku"
],
"country" : {
"country_code" : "JP",
"country_name" : "Japan"
},
"email_address" : null,
"established" : 1955,
"external_ids" : {
"GRID" : {
"all" : "grid.471938.0",
"preferred" : "grid.471938.0"
},
"ISNI" : {
"all" : [
"0000 0004 0643 0001"
],
"preferred" : null
},
"Wikidata" : {
"all" : [
"Q7105627"
],
"preferred" : null
}
},
"id" : "https://ror.org/01wtn4904",
"ip_addresses" : [],
"labels" : [
{
"iso639" : "ja",
"label" : "大阪女子短期大学"
}
],
"links" : [
"https://www.owjc.jp/"
],
"name" : "Osaka Women's Junior College",
"relationships" : [],
"status" : "inactive",
"types" : [
"Education"
],
"wikipedia_url" : "https://en.wikipedia.org/wiki/Osaka_Women%27s_Junior_College"
},
{
"acronyms" : [],
"addresses" : [
{
"city" : "Izumi",
"country_geonames_id" : null,
"geonames_city" : {
"city" : "Izumi",
"geonames_admin1" : {
"ascii_name" : null,
"code" : "JP.27",
"id" : null,
"name" : "Osaka"
},
"geonames_admin2" : {
"ascii_name" : null,
"code" : null,
"id" : null,
"name" : null
},
"id" : 1861107,
"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" : 34.48333,
"line" : null,
"lng" : 135.43333,
"postcode" : null,
"primary" : false,
"state" : null,
"state_code" : null
}
],
"aliases" : [
"Osaka Prefectural Industrial Technology Research Institute"
],
"country" : {
"country_code" : "JP",
"country_name" : "Japan"
},
"email_address" : null,
"established" : 1929,
"external_ids" : {
"GRID" : {
"all" : "grid.471622.4",
"preferred" : "grid.471622.4"
},
"ISNI" : {
"all" : [
"0000 0001 0198 5794"
],
"preferred" : null
}
},
"id" : "https://ror.org/008mb6p65",
"ip_addresses" : [],
"labels" : [
{
"iso639" : "ja",
"label" : "大阪府立産業技術総合研究所"
}
],
"links" : [
"http://tri-osaka.jp/"
],
"name" : "Technology Research Institute of Osaka Prefecture",
"relationships" : [
{
"id" : "https://ror.org/03r38cy24",
"label" : "Osaka Research Institute of Industrial Science and Technology",
"type" : "Successor"
}
],
"status" : "inactive",
"types" : [
"Facility"
],
"wikipedia_url" : null
}
],
"meta" : {
"countries" : [
{
"count" : 5,
"id" : "jp",
"title" : "Japan"
}
],
"statuses" : [
{
"count" : 5,
"id" : "inactive",
"title" : "inactive"
}
],
"types" : [
{
"count" : 4,
"id" : "education",
"title" : "Education"
},
{
"count" : 1,
"id" : "facility",
"title" : "Facility"
},
{
"count" : 1,
"id" : "funder",
"title" : "Funder"
}
]
},
"number_of_results" : 5,
"time_taken" : 3
}
Technical details
The query parameter searches abbreviated Elasticsearch documents (called names_ids) that combine all the values from each ROR record's name, aliases, labels, acronyms, id, and external_ids fields. For labels and external_ids, only the values (not the language code or type) are included. Field names are removed, and each value is simply categorized as a "name" or an "id".
Example
Here is a truncated example of a names_ids document searched by the query parameter.
"names_ids" : [
{
"name" : "University of Wisconsin–Madison"
},
{
"name" : "Université du Wisconsin à Madison"
},
{
"name" : "Universidad de Wisconsin-Madison"
},
{
"name" : "UW–Madison"
},
{
"name" : "UW"
},
{
"id" : "https://ror.org/01y2jtd41"
},
{
"id" : "ror.org/01y2jtd41"
},
{
"id" : "01y2jtd41"
},
...
Updated 8 days ago