Query parameter

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/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/organizations?query=Bath'

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 15 results, so only 15 items are returned.

{
   "items" : [
      {
         "acronyms" : [],
         "addresses" : [
            {
               "city" : "Bath",
               "country_geonames_id" : 2635167,
               "geonames_city" : {
                  "city" : "Bath",
                  "geonames_admin1" : {
                     "ascii_name" : "England",
                     "code" : "GB.ENG",
                     "id" : 6269131,
                     "name" : "England"
                  },
                  "geonames_admin2" : {
                     "ascii_name" : "Bath and North East Somerset",
                     "code" : "GB.ENG.A4",
                     "id" : 3333123,
                     "name" : "Bath and North East Somerset"
                  },
                  "id" : 2656173,
                  "license" : {
                     "attribution" : "Data from geonames.org under a CC-BY 3.0 license",
                     "license" : "http://creativecommons.org/licenses/by/3.0/"
                  },
                  "nuts_level1" : {
                     "code" : "UKK",
                     "name" : "SOUTH WEST (ENGLAND)"
                  },
                  "nuts_level2" : {
                     "code" : "UKK1",
                     "name" : "Gloucestershire, Wiltshire and Bristol/Bath area"
                  },
                  "nuts_level3" : {
                     "code" : "UKK12",
                     "name" : "Bath and North East Somerset, North Somerset and South Gloucestershire"
                  }
               },
               "lat" : 51.386501,
               "line" : null,
               "lng" : -2.364442,
               "postcode" : null,
               "primary" : false,
               "state" : null,
               "state_code" : null
            }
         ],
         "aliases" : [],
         "country" : {
            "country_code" : "GB",
            "country_name" : "United Kingdom"
         },
         "email_address" : null,
         "established" : 2003,
         "external_ids" : {
            "GRID" : {
               "all" : "grid.432411.1",
               "preferred" : "grid.432411.1"
            }
         },
         "id" : "https://ror.org/04hf68923",
         "ip_addresses" : [],
         "labels" : [],
         "links" : [
            "http://www.bathlabs.com/"
         ],
         "name" : "Bath Labs",
         "relationships" : [],
         "status" : "active",
         "types" : [
            "Facility"
         ],
         "wikipedia_url" : ""
      },
      {
         "acronyms" : [],
         "addresses" : [
            {
               "city" : "Bath",
               "country_geonames_id" : 2635167,
               "geonames_city" : {
                  "city" : "Bath",
                  "geonames_admin1" : {
                     "ascii_name" : "England",
                     "code" : "GB.ENG",
                     "id" : 6269131,
                     "name" : "England"
                  },
                  "geonames_admin2" : {
                     "ascii_name" : "Bath and North East Somerset",
                     "code" : "GB.ENG.A4",
                     "id" : 3333123,
                     "name" : "Bath and North East Somerset"
                  },
                  "id" : 2656173,
                  "license" : {
                     "attribution" : "Data from geonames.org under a CC-BY 3.0 license",
                     "license" : "http://creativecommons.org/licenses/by/3.0/"
                  },
                  "nuts_level1" : {
                     "code" : "UKK",
                     "name" : "SOUTH WEST (ENGLAND)"
                  },
                  "nuts_level2" : {
                     "code" : "UKK1",
                     "name" : "Gloucestershire, Wiltshire and Bristol/Bath area"
                  },
                  "nuts_level3" : {
                     "code" : "UKK12",
                     "name" : "Bath and North East Somerset, North Somerset and South Gloucestershire"
                  }
               },
               "lat" : 51.380148,
               "line" : null,
               "lng" : -2.362725,
               "postcode" : null,
               "primary" : false,
               "state" : null,
               "state_code" : null
            }
         ],
         "aliases" : [],
         "country" : {
            "country_code" : "GB",
            "country_name" : "United Kingdom"
         },
         "email_address" : null,
         "established" : 1892,
         "external_ids" : {
            "GRID" : {
               "all" : "grid.468747.e",
               "preferred" : "grid.468747.e"
            },
            "ISNI" : {
               "all" : [
                  "0000 0004 6437 268X"
               ],
               "preferred" : null
            },
            "OrgRef" : {
               "all" : [
                  "11933767"
               ],
               "preferred" : null
            },
            "Wikidata" : {
               "all" : [
                  "Q5123579"
               ],
               "preferred" : null
            }
         },
         "id" : "https://ror.org/00pbyj886",
         "ip_addresses" : [],
         "labels" : [],
         "links" : [
            "https://www.bathcollege.ac.uk/"
         ],
         "name" : "Bath College",
         "relationships" : [],
         "status" : "active",
         "types" : [
            "Education"
         ],
         "wikipedia_url" : "https://en.wikipedia.org/wiki/Bath_College"
      },
      {
         "acronyms" : [],
         "addresses" : [
            {
               "city" : "Bath",
               "country_geonames_id" : 2635167,
               "geonames_city" : {
                  "city" : "Bath",
                  "geonames_admin1" : {
                     "ascii_name" : "England",
                     "code" : "GB.ENG",
                     "id" : 6269131,
                     "name" : "England"
                  },
                  "geonames_admin2" : {
                     "ascii_name" : "Bath and North East Somerset",
                     "code" : "GB.ENG.A4",
                     "id" : 3333123,
                     "name" : "Bath and North East Somerset"
                  },
                  "id" : 2656173,
                  "license" : {
                     "attribution" : "Data from geonames.org under a CC-BY 3.0 license",
                     "license" : "http://creativecommons.org/licenses/by/3.0/"
                  },
                  "nuts_level1" : {
                     "code" : "UKK",
                     "name" : "SOUTH WEST (ENGLAND)"
                  },
                  "nuts_level2" : {
                     "code" : "UKK1",
                     "name" : "Gloucestershire, Wiltshire and Bristol/Bath area"
                  },
                  "nuts_level3" : {
                     "code" : "UKK12",
                     "name" : "Bath and North East Somerset, North Somerset and South Gloucestershire"
                  }
               },
               "lat" : 51.37598,
               "line" : null,
               "lng" : -2.438833,
               "postcode" : null,
               "primary" : false,
               "state" : "Bath and North East Somerset",
               "state_code" : "GB-BAS"
            }
         ],
         "aliases" : [
            "Bath College of Higher Education",
            "Bath Spa University College"
         ],
         "country" : {
            "country_code" : "GB",
            "country_name" : "United Kingdom"
         },
         "email_address" : null,
         "established" : 2005,
         "external_ids" : {
            "FundRef" : {
               "all" : [
                  "100010331"
               ],
               "preferred" : null
            },
            "GRID" : {
               "all" : "grid.252874.e",
               "preferred" : "grid.252874.e"
            },
            "HESA" : {
               "all" : [
                  "0048"
               ],
               "preferred" : null
            },
            "ISNI" : {
               "all" : [
                  "0000 0001 2034 9451"
               ],
               "preferred" : null
            },
            "OrgRef" : {
               "all" : [
                  "818426"
               ],
               "preferred" : null
            },
            "UCAS" : {
               "all" : [
                  "B20"
               ],
               "preferred" : null
            },
            "UKPRN" : {
               "all" : [
                  "10000571"
               ],
               "preferred" : null
            },
            "Wikidata" : {
               "all" : [
                  "Q3091754"
               ],
               "preferred" : null
            }
         },
         "id" : "https://ror.org/0038jbq24",
         "ip_addresses" : [],
         "labels" : [],
         "links" : [
            "https://www.bathspa.ac.uk/"
         ],
         "name" : "Bath Spa University",
         "relationships" : [],
         "status" : "active",
         "types" : [
            "Education"
         ],
         "wikipedia_url" : "http://en.wikipedia.org/wiki/Bath_Spa_University"
      },
      {
         "acronyms" : [],
         "addresses" : [
            {
               "city" : "Bath",
               "country_geonames_id" : 6252001,
               "geonames_city" : {
                  "city" : "Bath",
                  "geonames_admin1" : {
                     "ascii_name" : "Maine",
                     "code" : "US.ME",
                     "id" : 4971068,
                     "name" : "Maine"
                  },
                  "geonames_admin2" : {
                     "ascii_name" : "Sagadahoc County",
                     "code" : "US.ME.023",
                     "id" : 4977278,
                     "name" : "Sagadahoc County"
                  },
                  "id" : 4957570,
                  "license" : {
                     "attribution" : "Data from geonames.org under a CC-BY 3.0 license",
                     "license" : "http://creativecommons.org/licenses/by/3.0/"
                  },
                  "nuts_level1" : {
                     "code" : null,
                     "name" : null
                  },
                  "nuts_level2" : {
                     "code" : null,
                     "name" : null
                  },
                  "nuts_level3" : {
                     "code" : null,
                     "name" : null
                  }
               },
               "lat" : 43.893975,
               "line" : null,
               "lng" : -69.815909,
               "postcode" : null,
               "primary" : false,
               "state" : "Maine",
               "state_code" : "US-ME"
            }
         ],
         "aliases" : [
            "Bath Marine Museum"
         ],
         "country" : {
            "country_code" : "US",
            "country_name" : "United States"
         },
         "email_address" : null,
         "established" : 1962,
         "external_ids" : {
            "GRID" : {
               "all" : "grid.447036.2",
               "preferred" : "grid.447036.2"
            },
            "ISNI" : {
               "all" : [
                  "0000 0001 2226 6326"
               ],
               "preferred" : null
            }
         },
         "id" : "https://ror.org/0277k6k46",
         "ip_addresses" : [],
         "labels" : [],
         "links" : [
            "http://www.mainemaritimemuseum.org/"
         ],
         "name" : "Maine Maritime Museum",
         "relationships" : [],
         "status" : "active",
         "types" : [
            "Archive"
         ],
         "wikipedia_url" : "https://en.wikipedia.org/wiki/Maine_Maritime_Museum"
      },
      {
         "acronyms" : [],
         "addresses" : [
            {
               "city" : "Montreal",
               "country_geonames_id" : 6251999,
               "geonames_city" : {
                  "city" : "Montréal",
                  "geonames_admin1" : {
                     "ascii_name" : "Quebec",
                     "code" : "CA.10",
                     "id" : 6115047,
                     "name" : "Quebec"
                  },
                  "geonames_admin2" : {
                     "ascii_name" : "Montreal",
                     "code" : "CA.10.06",
                     "id" : 6077246,
                     "name" : "Montréal"
                  },
                  "id" : 6077243,
                  "license" : {
                     "attribution" : "Data from geonames.org under a CC-BY 3.0 license",
                     "license" : "http://creativecommons.org/licenses/by/3.0/"
                  },
                  "nuts_level1" : {
                     "code" : null,
                     "name" : null
                  },
                  "nuts_level2" : {
                     "code" : null,
                     "name" : null
                  },
                  "nuts_level3" : {
                     "code" : null,
                     "name" : null
                  }
               },
               "lat" : 45.437374,
               "line" : null,
               "lng" : -73.659299,
               "postcode" : null,
               "primary" : false,
               "state" : "Quebec",
               "state_code" : "CA-QC"
            }
         ],
         "aliases" : [],
         "country" : {
            "country_code" : "CA",
            "country_name" : "Canada"
         },
         "email_address" : null,
         "established" : 1969,
         "external_ids" : {
            "GRID" : {
               "all" : "grid.474071.1",
               "preferred" : "grid.474071.1"
            }
         },
         "id" : "https://ror.org/03zhn2w96",
         "ip_addresses" : [],
         "labels" : [],
         "links" : [
            "http://www.maax.com/en"
         ],
         "name" : "MAAX Bath (Canada)",
         "relationships" : [],
         "status" : "active",
         "types" : [
            "Company"
         ],
         "wikipedia_url" : ""
      },
      {
         "acronyms" : [],
         "addresses" : [
            {
               "city" : "Bath",
               "country_geonames_id" : 2635167,
               "geonames_city" : {
                  "city" : "Bath",
                  "geonames_admin1" : {
                     "ascii_name" : "England",
                     "code" : "GB.ENG",
                     "id" : 6269131,
                     "name" : "England"
                  },
                  "geonames_admin2" : {
                     "ascii_name" : "Bath and North East Somerset",
                     "code" : "GB.ENG.A4",
                     "id" : 3333123,
                     "name" : "Bath and North East Somerset"
                  },
                  "id" : 2656173,
                  "license" : {
                     "attribution" : "Data from geonames.org under a CC-BY 3.0 license",
                     "license" : "http://creativecommons.org/licenses/by/3.0/"
                  },
                  "nuts_level1" : {
                     "code" : null,
                     "name" : null
                  },
                  "nuts_level2" : {
                     "code" : null,
                     "name" : null
                  },
                  "nuts_level3" : {
                     "code" : null,
                     "name" : null
                  }
               },
               "lat" : 51.3751,
               "line" : null,
               "lng" : -2.36172,
               "postcode" : null,
               "primary" : false,
               "state" : null,
               "state_code" : null
            }
         ],
         "aliases" : [],
         "country" : {
            "country_code" : "GB",
            "country_name" : "United Kingdom"
         },
         "email_address" : null,
         "established" : 1966,
         "external_ids" : {
            "FundRef" : {
               "all" : [
                  "501100000835"
               ],
               "preferred" : null
            },
            "GRID" : {
               "all" : "grid.7340.0",
               "preferred" : "grid.7340.0"
            },
            "HESA" : {
               "all" : [
                  "0109"
               ],
               "preferred" : null
            },
            "ISNI" : {
               "all" : [
                  "0000 0001 2162 1699"
               ],
               "preferred" : null
            },
            "OrgRef" : {
               "all" : [
                  "153992"
               ],
               "preferred" : null
            },
            "UCAS" : {
               "all" : [
                  "B16"
               ],
               "preferred" : null
            },
            "UKPRN" : {
               "all" : [
                  "10007850"
               ],
               "preferred" : null
            },
            "Wikidata" : {
               "all" : [
                  "Q1422458"
               ],
               "preferred" : null
            }
         },
         "id" : "https://ror.org/002h8g185",
         "ip_addresses" : [],
         "labels" : [],
         "links" : [
            "http://www.bath.ac.uk/"
         ],
         "name" : "University of Bath",
         "relationships" : [
            {
               "id" : "https://ror.org/00a858n67",
               "label" : "Royal United Hospital",
               "type" : "Related"
            },
            {
               "id" : "https://ror.org/022p86748",
               "label" : "GW4 Facility for High-Resolution Electron Cryo-Microscopy",
               "type" : "Related"
            },
            {
               "id" : "https://ror.org/000vekr11",
               "label" : "GW4",
               "type" : "Related"
            }
         ],
         "status" : "active",
         "types" : [
            "Education"
         ],
         "wikipedia_url" : "http://en.wikipedia.org/wiki/University_of_Bath"
      },
      {
         "acronyms" : [],
         "addresses" : [
            {
               "city" : "Bath Beach",
               "country_geonames_id" : 6252001,
               "geonames_city" : {
                  "city" : "Bath Beach",
                  "geonames_admin1" : {
                     "ascii_name" : "New York",
                     "code" : "US.NY",
                     "id" : 5128638,
                     "name" : "New York"
                  },
                  "geonames_admin2" : {
                     "ascii_name" : "Kings County",
                     "code" : "US.NY.047",
                     "id" : 6941775,
                     "name" : "Kings County"
                  },
                  "id" : 5108111,
                  "license" : {
                     "attribution" : "Data from geonames.org under a CC-BY 3.0 license",
                     "license" : "http://creativecommons.org/licenses/by/3.0/"
                  },
                  "nuts_level1" : {
                     "code" : null,
                     "name" : null
                  },
                  "nuts_level2" : {
                     "code" : null,
                     "name" : null
                  },
                  "nuts_level3" : {
                     "code" : null,
                     "name" : null
                  }
               },
               "lat" : 42.343611,
               "line" : null,
               "lng" : -77.346111,
               "postcode" : null,
               "primary" : false,
               "state" : "New York",
               "state_code" : "US-NY"
            }
         ],
         "aliases" : [],
         "country" : {
            "country_code" : "US",
            "country_name" : "United States"
         },
         "email_address" : null,
         "established" : 1878,
         "external_ids" : {
            "GRID" : {
               "all" : "grid.509313.d",
               "preferred" : "grid.509313.d"
            },
            "ISNI" : {
               "all" : [
                  "0000 0004 0420 1096"
               ],
               "preferred" : null
            },
            "Wikidata" : {
               "all" : [
                  "Q4868960"
               ],
               "preferred" : null
            }
         },
         "id" : "https://ror.org/01d4n7s11",
         "ip_addresses" : [],
         "labels" : [],
         "links" : [
            "https://www.fingerlakes.va.gov/locations/Bath_VA_Medical_Center.asp"
         ],
         "name" : "Bath VA Medical Center",
         "relationships" : [
            {
               "id" : "https://ror.org/01rkxdk30",
               "label" : "VA Finger Lakes Healthcare System",
               "type" : "Parent"
            }
         ],
         "status" : "active",
         "types" : [
            "Healthcare"
         ],
         "wikipedia_url" : "https://en.wikipedia.org/wiki/Bath_VA_Medical_Center"
      },
      {
         "acronyms" : [
            "BIRD"
         ],
         "addresses" : [
            {
               "city" : "Bath",
               "country_geonames_id" : 2635167,
               "geonames_city" : {
                  "city" : "Bath",
                  "geonames_admin1" : {
                     "ascii_name" : "England",
                     "code" : "GB.ENG",
                     "id" : 6269131,
                     "name" : "England"
                  },
                  "geonames_admin2" : {
                     "ascii_name" : "Bath and North East Somerset",
                     "code" : "GB.ENG.A4",
                     "id" : 3333123,
                     "name" : "Bath and North East Somerset"
                  },
                  "id" : 2656173,
                  "license" : {
                     "attribution" : "Data from geonames.org under a CC-BY 3.0 license",
                     "license" : "http://creativecommons.org/licenses/by/3.0/"
                  },
                  "nuts_level1" : {
                     "code" : "UKK",
                     "name" : "SOUTH WEST (ENGLAND)"
                  },
                  "nuts_level2" : {
                     "code" : "UKK1",
                     "name" : "Gloucestershire, Wiltshire and Bristol/Bath area"
                  },
                  "nuts_level3" : {
                     "code" : "UKK12",
                     "name" : "Bath and North East Somerset, North Somerset and South Gloucestershire"
                  }
               },
               "lat" : 51.382563,
               "line" : null,
               "lng" : -2.36202,
               "postcode" : null,
               "primary" : false,
               "state" : null,
               "state_code" : null
            }
         ],
         "aliases" : [],
         "country" : {
            "country_code" : "GB",
            "country_name" : "United Kingdom"
         },
         "email_address" : null,
         "established" : 1975,
         "external_ids" : {
            "GRID" : {
               "all" : "grid.418231.d",
               "preferred" : "grid.418231.d"
            },
            "ISNI" : {
               "all" : [
                  "0000 0004 0641 831X"
               ],
               "preferred" : null
            },
            "Wikidata" : {
               "all" : [
                  "Q30281630"
               ],
               "preferred" : null
            }
         },
         "id" : "https://ror.org/05tacab76",
         "ip_addresses" : [],
         "labels" : [],
         "links" : [
            "http://www.birdbath.org.uk/"
         ],
         "name" : "Bath Institute for Rheumatic Diseases",
         "relationships" : [],
         "status" : "active",
         "types" : [
            "Nonprofit"
         ],
         "wikipedia_url" : ""
      },
      {
         "acronyms" : [],
         "addresses" : [
            {
               "city" : "Bath",
               "country_geonames_id" : 2635167,
               "geonames_city" : {
                  "city" : "Bath",
                  "geonames_admin1" : {
                     "ascii_name" : "England",
                     "code" : "GB.ENG",
                     "id" : 6269131,
                     "name" : "England"
                  },
                  "geonames_admin2" : {
                     "ascii_name" : "Bath and North East Somerset",
                     "code" : "GB.ENG.A4",
                     "id" : 3333123,
                     "name" : "Bath and North East Somerset"
                  },
                  "id" : 2656173,
                  "license" : {
                     "attribution" : "Data from geonames.org under a CC-BY 3.0 license",
                     "license" : "http://creativecommons.org/licenses/by/3.0/"
                  },
                  "nuts_level1" : {
                     "code" : "UKK",
                     "name" : "SOUTH WEST (ENGLAND)"
                  },
                  "nuts_level2" : {
                     "code" : "UKK1",
                     "name" : "Gloucestershire, Wiltshire and Bristol/Bath area"
                  },
                  "nuts_level3" : {
                     "code" : "UKK12",
                     "name" : "Bath and North East Somerset, North Somerset and South Gloucestershire"
                  }
               },
               "lat" : 51.391294,
               "line" : null,
               "lng" : -2.393219,
               "postcode" : null,
               "primary" : false,
               "state" : null,
               "state_code" : null
            }
         ],
         "aliases" : [
            "Bath Institute of Medical Engineering"
         ],
         "country" : {
            "country_code" : "GB",
            "country_name" : "United Kingdom"
         },
         "email_address" : null,
         "established" : 1968,
         "external_ids" : {
            "GRID" : {
               "all" : "grid.486748.1",
               "preferred" : "grid.486748.1"
            },
            "ISNI" : {
               "all" : [
                  "0000 0004 0449 0078"
               ],
               "preferred" : null
            }
         },
         "id" : "https://ror.org/01datx010",
         "ip_addresses" : [],
         "labels" : [],
         "links" : [
            "http://www.designability.org.uk/"
         ],
         "name" : "Designability",
         "relationships" : [],
         "status" : "active",
         "types" : [
            "Nonprofit"
         ],
         "wikipedia_url" : "https://en.wikipedia.org/wiki/Bath_Institute_of_Medical_Engineering"
      },
      {
         "acronyms" : [
            "BBSP"
         ],
         "addresses" : [
            {
               "city" : "Bristol",
               "country_geonames_id" : 2635167,
               "geonames_city" : {
                  "city" : "Bristol",
                  "geonames_admin1" : {
                     "ascii_name" : "England",
                     "code" : "GB.ENG",
                     "id" : 6269131,
                     "name" : "England"
                  },
                  "geonames_admin2" : {
                     "ascii_name" : "City of Bristol",
                     "code" : "GB.ENG.B7",
                     "id" : 3333134,
                     "name" : "City of Bristol"
                  },
                  "id" : 2654675,
                  "license" : {
                     "attribution" : "Data from geonames.org under a CC-BY 3.0 license",
                     "license" : "http://creativecommons.org/licenses/by/3.0/"
                  },
                  "nuts_level1" : {
                     "code" : "UKK",
                     "name" : "SOUTH WEST (ENGLAND)"
                  },
                  "nuts_level2" : {
                     "code" : "UKK1",
                     "name" : "Gloucestershire, Wiltshire and Bristol/Bath area"
                  },
                  "nuts_level3" : {
                     "code" : "UKK12",
                     "name" : "Bath and North East Somerset, North Somerset and South Gloucestershire"
                  }
               },
               "lat" : 51.501223,
               "line" : null,
               "lng" : -2.478679,
               "postcode" : null,
               "primary" : false,
               "state" : null,
               "state_code" : null
            }
         ],
         "aliases" : [],
         "country" : {
            "country_code" : "GB",
            "country_name" : "United Kingdom"
         },
         "email_address" : null,
         "established" : 2011,
         "external_ids" : {
            "GRID" : {
               "all" : "grid.498158.9",
               "preferred" : "grid.498158.9"
            }
         },
         "id" : "https://ror.org/0105p2r38",
         "ip_addresses" : [],
         "labels" : [],
         "links" : [
            "https://www.bbsp.co.uk/"
         ],
         "name" : "Bristol and Bath Science Park",
         "relationships" : [],
         "status" : "active",
         "types" : [
            "Education"
         ],
         "wikipedia_url" : "https://en.wikipedia.org/wiki/Bristol_and_Bath_Science_Park"
      },
      {
         "acronyms" : [
            "BSDR"
         ],
         "addresses" : [
            {
               "city" : "Bath",
               "country_geonames_id" : 2635167,
               "geonames_city" : {
                  "city" : "Bath",
                  "geonames_admin1" : {
                     "ascii_name" : "England",
                     "code" : "GB.ENG",
                     "id" : 6269131,
                     "name" : "England"
                  },
                  "geonames_admin2" : {
                     "ascii_name" : "Bath and North East Somerset",
                     "code" : "GB.ENG.A4",
                     "id" : 3333123,
                     "name" : "Bath and North East Somerset"
                  },
                  "id" : 2656173,
                  "license" : {
                     "attribution" : "Data from geonames.org under a CC-BY 3.0 license",
                     "license" : "http://creativecommons.org/licenses/by/3.0/"
                  },
                  "nuts_level1" : {
                     "code" : "UKK",
                     "name" : "SOUTH WEST (ENGLAND)"
                  },
                  "nuts_level2" : {
                     "code" : "UKK1",
                     "name" : "Gloucestershire, Wiltshire and Bristol/Bath area"
                  },
                  "nuts_level3" : {
                     "code" : "UKK12",
                     "name" : "Bath and North East Somerset, North Somerset and South Gloucestershire"
                  }
               },
               "lat" : 51.387285,
               "line" : null,
               "lng" : -2.397273,
               "postcode" : null,
               "primary" : false,
               "state" : null,
               "state_code" : null
            }
         ],
         "aliases" : [],
         "country" : {
            "country_code" : "GB",
            "country_name" : "United Kingdom"
         },
         "email_address" : null,
         "established" : 2016,
         "external_ids" : {
            "GRID" : {
               "all" : "grid.499705.6",
               "preferred" : "grid.499705.6"
            }
         },
         "id" : "https://ror.org/02fzzq880",
         "ip_addresses" : [],
         "labels" : [],
         "links" : [
            "http://bathsdr.org/"
         ],
         "name" : "Bath Social and Development Research",
         "relationships" : [],
         "status" : "active",
         "types" : [
            "Nonprofit"
         ],
         "wikipedia_url" : ""
      },
      {
         "acronyms" : [
            "BRLSI"
         ],
         "addresses" : [
            {
               "city" : "Bath",
               "country_geonames_id" : 2635167,
               "geonames_city" : {
                  "city" : "Bath",
                  "geonames_admin1" : {
                     "ascii_name" : "England",
                     "code" : "GB.ENG",
                     "id" : 6269131,
                     "name" : "England"
                  },
                  "geonames_admin2" : {
                     "ascii_name" : "Bath and North East Somerset",
                     "code" : "GB.ENG.A4",
                     "id" : 3333123,
                     "name" : "Bath and North East Somerset"
                  },
                  "id" : 2656173,
                  "license" : {
                     "attribution" : "Data from geonames.org under a CC-BY 3.0 license",
                     "license" : "http://creativecommons.org/licenses/by/3.0/"
                  },
                  "nuts_level1" : {
                     "code" : 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" : 2635167,
               "geonames_city" : {
                  "city" : "Bath",
                  "geonames_admin1" : {
                     "ascii_name" : "England",
                     "code" : "GB.ENG",
                     "id" : 6269131,
                     "name" : "England"
                  },
                  "geonames_admin2" : {
                     "ascii_name" : "Bath and North East Somerset",
                     "code" : "GB.ENG.A4",
                     "id" : 3333123,
                     "name" : "Bath and North East Somerset"
                  },
                  "id" : 2656173,
                  "license" : {
                     "attribution" : "Data from geonames.org under a CC-BY 3.0 license",
                     "license" : "http://creativecommons.org/licenses/by/3.0/"
                  },
                  "nuts_level1" : {
                     "code" : "UKK",
                     "name" : "SOUTH WEST (ENGLAND)"
                  },
                  "nuts_level2" : {
                     "code" : "UKK1",
                     "name" : "Gloucestershire, Wiltshire and Bristol/Bath area"
                  },
                  "nuts_level3" : {
                     "code" : "UKK12",
                     "name" : "Bath and North East Somerset, North Somerset and South Gloucestershire"
                  }
               },
               "lat" : 51.391932,
               "line" : null,
               "lng" : -2.389183,
               "postcode" : null,
               "primary" : false,
               "state" : "Somerset",
               "state_code" : "GB-SOM"
            }
         ],
         "aliases" : [
            "Royal United Hospital Bath NHS Foundation Trust"
         ],
         "country" : {
            "country_code" : "GB",
            "country_name" : "United Kingdom"
         },
         "email_address" : null,
         "established" : 1864,
         "external_ids" : {
            "GRID" : {
               "all" : "grid.413029.d",
               "preferred" : "grid.413029.d"
            },
            "ISNI" : {
               "all" : [
                  "0000 0004 0374 2907"
               ],
               "preferred" : null
            },
            "OrgRef" : {
               "all" : [
                  "26346979"
               ],
               "preferred" : null
            },
            "Wikidata" : {
               "all" : [
                  "Q18162105"
               ],
               "preferred" : null
            }
         },
         "id" : "https://ror.org/058x7dy48",
         "ip_addresses" : [],
         "labels" : [],
         "links" : [
            "http://www.ruh.nhs.uk/"
         ],
         "name" : "Royal United Hospital Bath NHS Trust",
         "relationships" : [
            {
               "id" : "https://ror.org/05f9e0404",
               "label" : "Paulton Hospital",
               "type" : "Child"
            },
            {
               "id" : "https://ror.org/05va5gy74",
               "label" : "Royal National Hospital for Rheumatic Diseases",
               "type" : "Child"
            },
            {
               "id" : "https://ror.org/00a858n67",
               "label" : "Royal United Hospital",
               "type" : "Child"
            }
         ],
         "status" : "active",
         "types" : [
            "Healthcare"
         ],
         "wikipedia_url" : "https://en.wikipedia.org/wiki/Royal_United_Hospital_Bath_NHS_Foundation_Trust"
      },
      {
         "acronyms" : [],
         "addresses" : [
            {
               "city" : "Bath",
               "country_geonames_id" : 2635167,
               "geonames_city" : {
                  "city" : "Bath",
                  "geonames_admin1" : {
                     "ascii_name" : "England",
                     "code" : "GB.ENG",
                     "id" : 6269131,
                     "name" : "England"
                  },
                  "geonames_admin2" : {
                     "ascii_name" : "Bath and North East Somerset",
                     "code" : "GB.ENG.A4",
                     "id" : 3333123,
                     "name" : "Bath and North East Somerset"
                  },
                  "id" : 2656173,
                  "license" : {
                     "attribution" : "Data from geonames.org under a CC-BY 3.0 license",
                     "license" : "http://creativecommons.org/licenses/by/3.0/"
                  },
                  "nuts_level1" : {
                     "code" : "UKK",
                     "name" : "SOUTH WEST (ENGLAND)"
                  },
                  "nuts_level2" : {
                     "code" : "UKK1",
                     "name" : "Gloucestershire, Wiltshire and Bristol/Bath area"
                  },
                  "nuts_level3" : {
                     "code" : "UKK12",
                     "name" : "Bath and North East Somerset, North Somerset and South Gloucestershire"
                  }
               },
               "lat" : 51.415436,
               "line" : null,
               "lng" : -2.491173,
               "postcode" : null,
               "primary" : false,
               "state" : null,
               "state_code" : null
            }
         ],
         "aliases" : [],
         "country" : {
            "country_code" : "GB",
            "country_name" : "United Kingdom"
         },
         "email_address" : "",
         "established" : 1996,
         "external_ids" : {
            "GRID" : {
               "all" : "grid.450510.5",
               "preferred" : "grid.450510.5"
            },
            "ISNI" : {
               "all" : [
                  "0000 0004 0374 2966"
               ],
               "preferred" : null
            },
            "Wikidata" : {
               "all" : [
                  "Q16966588"
               ],
               "preferred" : null
            }
         },
         "id" : "https://ror.org/03rwxcx12",
         "ip_addresses" : [],
         "labels" : [],
         "links" : [
            "http://www.bathnes.gov.uk/"
         ],
         "name" : "Bath and North East Somerset Council",
         "relationships" : [],
         "status" : "active",
         "types" : [
            "Government"
         ],
         "wikipedia_url" : "https://en.wikipedia.org/wiki/Bath_and_North_East_Somerset_Council"
      },
      {
         "acronyms" : [
            "BaNES CCG"
         ],
         "addresses" : [
            {
               "city" : "Bath",
               "country_geonames_id" : 2635167,
               "geonames_city" : {
                  "city" : "Bath",
                  "geonames_admin1" : {
                     "ascii_name" : "England",
                     "code" : "GB.ENG",
                     "id" : 6269131,
                     "name" : "England"
                  },
                  "geonames_admin2" : {
                     "ascii_name" : "Bath and North East Somerset",
                     "code" : "GB.ENG.A4",
                     "id" : 3333123,
                     "name" : "Bath and North East Somerset"
                  },
                  "id" : 2656173,
                  "license" : {
                     "attribution" : "Data from geonames.org under a CC-BY 3.0 license",
                     "license" : "http://creativecommons.org/licenses/by/3.0/"
                  },
                  "nuts_level1" : {
                     "code" : "UKK",
                     "name" : "SOUTH WEST (ENGLAND)"
                  },
                  "nuts_level2" : {
                     "code" : "UKK1",
                     "name" : "Gloucestershire, Wiltshire and Bristol/Bath area"
                  },
                  "nuts_level3" : {
                     "code" : "UKK12",
                     "name" : "Bath and North East Somerset, North Somerset and South Gloucestershire"
                  }
               },
               "lat" : 51.35779,
               "line" : null,
               "lng" : -2.372919,
               "postcode" : null,
               "primary" : false,
               "state" : null,
               "state_code" : null
            }
         ],
         "aliases" : [],
         "country" : {
            "country_code" : "GB",
            "country_name" : "United Kingdom"
         },
         "email_address" : null,
         "established" : null,
         "external_ids" : {
            "GRID" : {
               "all" : "grid.476920.e",
               "preferred" : "grid.476920.e"
            }
         },
         "id" : "https://ror.org/00pkb6h65",
         "ip_addresses" : [],
         "labels" : [],
         "links" : [
            "http://www.bathandnortheastsomersetccg.nhs.uk/"
         ],
         "name" : "Bath and North East Somerset Clinical Commissioning Group",
         "relationships" : [],
         "status" : "active",
         "types" : [
            "Healthcare"
         ],
         "wikipedia_url" : ""
      }
   ],
   "meta" : {
      "countries" : [
         {
            "count" : 12,
            "id" : "gb",
            "title" : "United Kingdom"
         },
         {
            "count" : 2,
            "id" : "us",
            "title" : "United States"
         },
         {
            "count" : 1,
            "id" : "ca",
            "title" : "Canada"
         }
      ],
      "statuses" : [
         {
            "count" : 15,
            "id" : "active",
            "title" : "active"
         }
      ],
      "types" : [
         {
            "count" : 4,
            "id" : "education",
            "title" : "Education"
         },
         {
            "count" : 3,
            "id" : "healthcare",
            "title" : "Healthcare"
         },
         {
            "count" : 3,
            "id" : "nonprofit",
            "title" : "Nonprofit"
         },
         {
            "count" : 1,
            "id" : "archive",
            "title" : "Archive"
         },
         {
            "count" : 1,
            "id" : "company",
            "title" : "Company"
         },
         {
            "count" : 1,
            "id" : "facility",
            "title" : "Facility"
         },
         {
            "count" : 1,
            "id" : "government",
            "title" : "Government"
         },
         {
            "count" : 1,
            "id" : "other",
            "title" : "Other"
         }
      ]
   },
   "number_of_results" : 15,
   "time_taken" : 6
}

🚧

Remember that the query parameter does not search all fields

The query parameter searches only the four name-related fields (name, acronyms, aliases, and labels) and the external_ids field. Results from keyword searches using the query parameter do not include values from location fields such as country and addresses, 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/organizations?query=Bath%20College'

This search looks for both the term "Bath" and the term "College" and returns 4608 results because the term "College" appears in many organization names. A search on the single term "Bath" produces only 15 results, because it is a much less common term in organization names. The organization record for Bath College is the first of the 4608 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" : 2635167,
               "geonames_city" : {
                  "city" : "Bath",
                  "geonames_admin1" : {
                     "ascii_name" : "England",
                     "code" : "GB.ENG",
                     "id" : 6269131,
                     "name" : "England"
                  },
                  "geonames_admin2" : {
                     "ascii_name" : "Bath and North East Somerset",
                     "code" : "GB.ENG.A4",
                     "id" : 3333123,
                     "name" : "Bath and North East Somerset"
                  },
                  "id" : 2656173,
                  "license" : {
                     "attribution" : "Data from geonames.org under a CC-BY 3.0 license",
                     "license" : "http://creativecommons.org/licenses/by/3.0/"
                  },
                  "nuts_level1" : {
                     "code" : "UKK",
                     "name" : "SOUTH WEST (ENGLAND)"
                  },
                  "nuts_level2" : {
                     "code" : "UKK1",
                     "name" : "Gloucestershire, Wiltshire and Bristol/Bath area"
                  },
                  "nuts_level3" : {
                     "code" : "UKK12",
                     "name" : "Bath and North East Somerset, North Somerset and South Gloucestershire"
                  }
               },
               "lat" : 51.380148,
               "line" : null,
               "lng" : -2.362725,
               "postcode" : null,
               "primary" : false,
               "state" : null,
               "state_code" : null
            }
         ],
         "aliases" : [],
         "country" : {
            "country_code" : "GB",
            "country_name" : "United Kingdom"
         },
         "email_address" : null,
         "established" : 1892,
         "external_ids" : {
            "GRID" : {
               "all" : "grid.468747.e",
               "preferred" : "grid.468747.e"
            },
            "ISNI" : {
               "all" : [
                  "0000 0004 6437 268X"
               ],
               "preferred" : null
            },
            "OrgRef" : {
               "all" : [
                  "11933767"
               ],
               "preferred" : null
            },
            "Wikidata" : {
               "all" : [
                  "Q5123579"
               ],
               "preferred" : null
            }
         },
         "id" : "https://ror.org/00pbyj886",
         "ip_addresses" : [],
         "labels" : [],
         "links" : [
            "https://www.bathcollege.ac.uk/"
         ],
         "name" : "Bath College",
         "relationships" : [],
         "status" : "active",
         "types" : [
            "Education"
         ],
         "wikipedia_url" : "https://en.wikipedia.org/wiki/Bath_College"
      },
      {
         "acronyms" : [],
         "addresses" : [
            {
               "city" : "Bath",
               "country_geonames_id" : 2635167,
               "geonames_city" : {
                  "city" : "Bath",
                  "geonames_admin1" : {
                     "ascii_name" : "England",
                     "code" : "GB.ENG",
                     "id" : 6269131,
                     "name" : "England"
                  },
                  "geonames_admin2" : {
                     "ascii_name" : "Bath and North East Somerset",
                     "code" : "GB.ENG.A4",
                     "id" : 3333123,
                     "name" : "Bath and North East Somerset"
                  },
                  "id" : 2656173,
                  "license" : {
                     "attribution" : "Data from geonames.org under a CC-BY 3.0 license",
                     "license" : "http://creativecommons.org/licenses/by/3.0/"
                  },
                  "nuts_level1" : {
                     "code" : "UKK",
                     "name" : "SOUTH WEST (ENGLAND)"
                  },
                  "nuts_level2" : {
                     "code" : "UKK1",
                     "name" : "Gloucestershire, Wiltshire and Bristol/Bath area"
                  },
                  "nuts_level3" : {
                     "code" : "UKK12",
                     "name" : "Bath and North East Somerset, North Somerset and South Gloucestershire"
                  }
               },
               "lat" : 51.37598,
               "line" : null,
               "lng" : -2.438833,
               "postcode" : null,
               "primary" : false,
               "state" : "Bath and North East Somerset",
               "state_code" : "GB-BAS"
            }
         ],
         "aliases" : [
            "Bath College of Higher Education",
            "Bath Spa University College"
         ],
         "country" : {
            "country_code" : "GB",
            "country_name" : "United Kingdom"
         },
         "email_address" : null,
         "established" : 2005,
         "external_ids" : {
            "FundRef" : {
               "all" : [
                  "100010331"
               ],
               "preferred" : null
            },
            "GRID" : {
               "all" : "grid.252874.e",
               "preferred" : "grid.252874.e"
            },
            "HESA" : {
               "all" : [
                  "0048"
               ],
               "preferred" : null
            },
            "ISNI" : {
               "all" : [
                  "0000 0001 2034 9451"
               ],
               "preferred" : null
            },
            "OrgRef" : {
               "all" : [
                  "818426"
               ],
               "preferred" : null
            },
            "UCAS" : {
               "all" : [
                  "B20"
               ],
               "preferred" : null
            },
            "UKPRN" : {
               "all" : [
                  "10000571"
               ],
               "preferred" : null
            },
            "Wikidata" : {
               "all" : [
                  "Q3091754"
               ],
               "preferred" : null
            }
         },
         "id" : "https://ror.org/0038jbq24",
         "ip_addresses" : [],
         "labels" : [],
         "links" : [
            "https://www.bathspa.ac.uk/"
         ],
         "name" : "Bath Spa University",
         "relationships" : [],
         "status" : "active",
         "types" : [
            "Education"
         ],
         "wikipedia_url" : "http://en.wikipedia.org/wiki/Bath_Spa_University"
      },
      {
         "acronyms" : [],
         "addresses" : [
            {
               "city" : "Bath",
               "country_geonames_id" : 2635167,
               "geonames_city" : {
                  "city" : "Bath",
                  "geonames_admin1" : {
                     "ascii_name" : "England",
                     "code" : "GB.ENG",
                     "id" : 6269131,
                     "name" : "England"
                  },
                  "geonames_admin2" : {
                     "ascii_name" : "Bath and North East Somerset",
                     "code" : "GB.ENG.A4",
                     "id" : 3333123,
                     "name" : "Bath and North East Somerset"
                  },
                  "id" : 2656173,
                  "license" : {
                     "attribution" : "Data from geonames.org under a CC-BY 3.0 license",
                     "license" : "http://creativecommons.org/licenses/by/3.0/"
                  },
                  "nuts_level1" : {
                     "code" : "UKK",
                     "name" : "SOUTH WEST (ENGLAND)"
                  },
                  "nuts_level2" : {
                     "code" : "UKK1",
                     "name" : "Gloucestershire, Wiltshire and Bristol/Bath area"
                  },
                  "nuts_level3" : {
                     "code" : "UKK12",
                     "name" : "Bath and North East Somerset, North Somerset and South Gloucestershire"
                  }
               },
               "lat" : 51.386501,
               "line" : null,
               "lng" : -2.364442,
               "postcode" : null,
               "primary" : false,
               "state" : null,
               "state_code" : null
            }
         ],
         "aliases" : [],
         "country" : {
            "country_code" : "GB",
            "country_name" : "United Kingdom"
         },
         "email_address" : null,
         "established" : 2003,
         "external_ids" : {
            "GRID" : {
               "all" : "grid.432411.1",
               "preferred" : "grid.432411.1"
            }
         },
         "id" : "https://ror.org/04hf68923",
         "ip_addresses" : [],
         "labels" : [],
         "links" : [
            "http://www.bathlabs.com/"
         ],
         "name" : "Bath Labs",
         "relationships" : [],
         "status" : "active",
         "types" : [
            "Facility"
         ],
         "wikipedia_url" : ""
      },
      {
         "acronyms" : [],
         "addresses" : [
            {
               "city" : "Bath",
               "country_geonames_id" : 6252001,
               "geonames_city" : {
                  "city" : "Bath",
                  "geonames_admin1" : {
                     "ascii_name" : "Maine",
                     "code" : "US.ME",
                     "id" : 4971068,
                     "name" : "Maine"
                  },
                  "geonames_admin2" : {
                     "ascii_name" : "Sagadahoc County",
                     "code" : "US.ME.023",
                     "id" : 4977278,
                     "name" : "Sagadahoc County"
                  },
                  "id" : 4957570,
                  "license" : {
                     "attribution" : "Data from geonames.org under a CC-BY 3.0 license",
                     "license" : "http://creativecommons.org/licenses/by/3.0/"
                  },
                  "nuts_level1" : {
                     "code" : null,
                     "name" : null
                  },
                  "nuts_level2" : {
                     "code" : null,
                     "name" : null
                  },
                  "nuts_level3" : {
                     "code" : null,
                     "name" : null
                  }
               },
               "lat" : 43.893975,
               "line" : null,
               "lng" : -69.815909,
               "postcode" : null,
               "primary" : false,
               "state" : "Maine",
               "state_code" : "US-ME"
            }
         ],
         "aliases" : [
            "Bath Marine Museum"
         ],
         "country" : {
            "country_code" : "US",
            "country_name" : "United States"
         },
         "email_address" : null,
         "established" : 1962,
         "external_ids" : {
            "GRID" : {
               "all" : "grid.447036.2",
               "preferred" : "grid.447036.2"
            },
            "ISNI" : {
               "all" : [
                  "0000 0001 2226 6326"
               ],
               "preferred" : null
            }
         },
         "id" : "https://ror.org/0277k6k46",
         "ip_addresses" : [],
         "labels" : [],
         "links" : [
            "http://www.mainemaritimemuseum.org/"
         ],
         "name" : "Maine Maritime Museum",
         "relationships" : [],
         "status" : "active",
         "types" : [
            "Archive"
         ],
         "wikipedia_url" : "https://en.wikipedia.org/wiki/Maine_Maritime_Museum"
      },
      {
         "acronyms" : [],
         "addresses" : [
            {
               "city" : "Montreal",
               "country_geonames_id" : 6251999,
               "geonames_city" : {
                  "city" : "Montréal",
                  "geonames_admin1" : {
                     "ascii_name" : "Quebec",
                     "code" : "CA.10",
                     "id" : 6115047,
                     "name" : "Quebec"
                  },
                  "geonames_admin2" : {
                     "ascii_name" : "Montreal",
                     "code" : "CA.10.06",
                     "id" : 6077246,
                     "name" : "Montréal"
                  },
                  "id" : 6077243,
                  "license" : {
                     "attribution" : "Data from geonames.org under a CC-BY 3.0 license",
                     "license" : "http://creativecommons.org/licenses/by/3.0/"
                  },
                  "nuts_level1" : {
                     "code" : null,
                     "name" : null
                  },
                  "nuts_level2" : {
                     "code" : null,
                     "name" : null
                  },
                  "nuts_level3" : {
                     "code" : null,
                     "name" : null
                  }
               },
               "lat" : 45.437374,
               "line" : null,
               "lng" : -73.659299,
               "postcode" : null,
               "primary" : false,
               "state" : "Quebec",
               "state_code" : "CA-QC"
            }
         ],
         "aliases" : [],
         "country" : {
            "country_code" : "CA",
            "country_name" : "Canada"
         },
         "email_address" : null,
         "established" : 1969,
         "external_ids" : {
            "GRID" : {
               "all" : "grid.474071.1",
               "preferred" : "grid.474071.1"
            }
         },
         "id" : "https://ror.org/03zhn2w96",
         "ip_addresses" : [],
         "labels" : [],
         "links" : [
            "http://www.maax.com/en"
         ],
         "name" : "MAAX Bath (Canada)",
         "relationships" : [],
         "status" : "active",
         "types" : [
            "Company"
         ],
         "wikipedia_url" : ""
      },
      {
         "acronyms" : [],
         "addresses" : [
            {
               "city" : "Bath",
               "country_geonames_id" : 2635167,
               "geonames_city" : {
                  "city" : "Bath",
                  "geonames_admin1" : {
                     "ascii_name" : "England",
                     "code" : "GB.ENG",
                     "id" : 6269131,
                     "name" : "England"
                  },
                  "geonames_admin2" : {
                     "ascii_name" : "Bath and North East Somerset",
                     "code" : "GB.ENG.A4",
                     "id" : 3333123,
                     "name" : "Bath and North East Somerset"
                  },
                  "id" : 2656173,
                  "license" : {
                     "attribution" : "Data from geonames.org under a CC-BY 3.0 license",
                     "license" : "http://creativecommons.org/licenses/by/3.0/"
                  },
                  "nuts_level1" : {
                     "code" : null,
                     "name" : null
                  },
                  "nuts_level2" : {
                     "code" : null,
                     "name" : null
                  },
                  "nuts_level3" : {
                     "code" : null,
                     "name" : null
                  }
               },
               "lat" : 51.3751,
               "line" : null,
               "lng" : -2.36172,
               "postcode" : null,
               "primary" : false,
               "state" : null,
               "state_code" : null
            }
         ],
         "aliases" : [],
         "country" : {
            "country_code" : "GB",
            "country_name" : "United Kingdom"
         },
         "email_address" : null,
         "established" : 1966,
         "external_ids" : {
            "FundRef" : {
               "all" : [
                  "501100000835"
               ],
               "preferred" : null
            },
            "GRID" : {
               "all" : "grid.7340.0",
               "preferred" : "grid.7340.0"
            },
            "HESA" : {
               "all" : [
                  "0109"
               ],
               "preferred" : null
            },
            "ISNI" : {
               "all" : [
                  "0000 0001 2162 1699"
               ],
               "preferred" : null
            },
            "OrgRef" : {
               "all" : [
                  "153992"
               ],
               "preferred" : null
            },
            "UCAS" : {
               "all" : [
                  "B16"
               ],
               "preferred" : null
            },
            "UKPRN" : {
               "all" : [
                  "10007850"
               ],
               "preferred" : null
            },
            "Wikidata" : {
               "all" : [
                  "Q1422458"
               ],
               "preferred" : null
            }
         },
         "id" : "https://ror.org/002h8g185",
         "ip_addresses" : [],
         "labels" : [],
         "links" : [
            "http://www.bath.ac.uk/"
         ],
         "name" : "University of Bath",
         "relationships" : [
            {
               "id" : "https://ror.org/00a858n67",
               "label" : "Royal United Hospital",
               "type" : "Related"
            },
            {
               "id" : "https://ror.org/022p86748",
               "label" : "GW4 Facility for High-Resolution Electron Cryo-Microscopy",
               "type" : "Related"
            },
            {
               "id" : "https://ror.org/000vekr11",
               "label" : "GW4",
               "type" : "Related"
            }
         ],
         "status" : "active",
         "types" : [
            "Education"
         ],
         "wikipedia_url" : "http://en.wikipedia.org/wiki/University_of_Bath"
      },
      {
         "acronyms" : [],
         "addresses" : [
            {
               "city" : "Bath Beach",
               "country_geonames_id" : 6252001,
               "geonames_city" : {
                  "city" : "Bath Beach",
                  "geonames_admin1" : {
                     "ascii_name" : "New York",
                     "code" : "US.NY",
                     "id" : 5128638,
                     "name" : "New York"
                  },
                  "geonames_admin2" : {
                     "ascii_name" : "Kings County",
                     "code" : "US.NY.047",
                     "id" : 6941775,
                     "name" : "Kings County"
                  },
                  "id" : 5108111,
                  "license" : {
                     "attribution" : "Data from geonames.org under a CC-BY 3.0 license",
                     "license" : "http://creativecommons.org/licenses/by/3.0/"
                  },
                  "nuts_level1" : {
                     "code" : null,
                     "name" : null
                  },
                  "nuts_level2" : {
                     "code" : null,
                     "name" : null
                  },
                  "nuts_level3" : {
                     "code" : null,
                     "name" : null
                  }
               },
               "lat" : 42.343611,
               "line" : null,
               "lng" : -77.346111,
               "postcode" : null,
               "primary" : false,
               "state" : "New York",
               "state_code" : "US-NY"
            }
         ],
         "aliases" : [],
         "country" : {
            "country_code" : "US",
            "country_name" : "United States"
         },
         "email_address" : null,
         "established" : 1878,
         "external_ids" : {
            "GRID" : {
               "all" : "grid.509313.d",
               "preferred" : "grid.509313.d"
            },
            "ISNI" : {
               "all" : [
                  "0000 0004 0420 1096"
               ],
               "preferred" : null
            },
            "Wikidata" : {
               "all" : [
                  "Q4868960"
               ],
               "preferred" : null
            }
         },
         "id" : "https://ror.org/01d4n7s11",
         "ip_addresses" : [],
         "labels" : [],
         "links" : [
            "https://www.fingerlakes.va.gov/locations/Bath_VA_Medical_Center.asp"
         ],
         "name" : "Bath VA Medical Center",
         "relationships" : [
            {
               "id" : "https://ror.org/01rkxdk30",
               "label" : "VA Finger Lakes Healthcare System",
               "type" : "Parent"
            }
         ],
         "status" : "active",
         "types" : [
            "Healthcare"
         ],
         "wikipedia_url" : "https://en.wikipedia.org/wiki/Bath_VA_Medical_Center"
      },
      {
         "acronyms" : [
            "BIRD"
         ],
         "addresses" : [
            {
               "city" : "Bath",
               "country_geonames_id" : 2635167,
               "geonames_city" : {
                  "city" : "Bath",
                  "geonames_admin1" : {
                     "ascii_name" : "England",
                     "code" : "GB.ENG",
                     "id" : 6269131,
                     "name" : "England"
                  },
                  "geonames_admin2" : {
                     "ascii_name" : "Bath and North East Somerset",
                     "code" : "GB.ENG.A4",
                     "id" : 3333123,
                     "name" : "Bath and North East Somerset"
                  },
                  "id" : 2656173,
                  "license" : {
                     "attribution" : "Data from geonames.org under a CC-BY 3.0 license",
                     "license" : "http://creativecommons.org/licenses/by/3.0/"
                  },
                  "nuts_level1" : {
                     "code" : "UKK",
                     "name" : "SOUTH WEST (ENGLAND)"
                  },
                  "nuts_level2" : {
                     "code" : "UKK1",
                     "name" : "Gloucestershire, Wiltshire and Bristol/Bath area"
                  },
                  "nuts_level3" : {
                     "code" : "UKK12",
                     "name" : "Bath and North East Somerset, North Somerset and South Gloucestershire"
                  }
               },
               "lat" : 51.382563,
               "line" : null,
               "lng" : -2.36202,
               "postcode" : null,
               "primary" : false,
               "state" : null,
               "state_code" : null
            }
         ],
         "aliases" : [],
         "country" : {
            "country_code" : "GB",
            "country_name" : "United Kingdom"
         },
         "email_address" : null,
         "established" : 1975,
         "external_ids" : {
            "GRID" : {
               "all" : "grid.418231.d",
               "preferred" : "grid.418231.d"
            },
            "ISNI" : {
               "all" : [
                  "0000 0004 0641 831X"
               ],
               "preferred" : null
            },
            "Wikidata" : {
               "all" : [
                  "Q30281630"
               ],
               "preferred" : null
            }
         },
         "id" : "https://ror.org/05tacab76",
         "ip_addresses" : [],
         "labels" : [],
         "links" : [
            "http://www.birdbath.org.uk/"
         ],
         "name" : "Bath Institute for Rheumatic Diseases",
         "relationships" : [],
         "status" : "active",
         "types" : [
            "Nonprofit"
         ],
         "wikipedia_url" : ""
      },
      {
         "acronyms" : [],
         "addresses" : [
            {
               "city" : "Bath",
               "country_geonames_id" : 2635167,
               "geonames_city" : {
                  "city" : "Bath",
                  "geonames_admin1" : {
                     "ascii_name" : "England",
                     "code" : "GB.ENG",
                     "id" : 6269131,
                     "name" : "England"
                  },
                  "geonames_admin2" : {
                     "ascii_name" : "Bath and North East Somerset",
                     "code" : "GB.ENG.A4",
                     "id" : 3333123,
                     "name" : "Bath and North East Somerset"
                  },
                  "id" : 2656173,
                  "license" : {
                     "attribution" : "Data from geonames.org under a CC-BY 3.0 license",
                     "license" : "http://creativecommons.org/licenses/by/3.0/"
                  },
                  "nuts_level1" : {
                     "code" : "UKK",
                     "name" : "SOUTH WEST (ENGLAND)"
                  },
                  "nuts_level2" : {
                     "code" : "UKK1",
                     "name" : "Gloucestershire, Wiltshire and Bristol/Bath area"
                  },
                  "nuts_level3" : {
                     "code" : "UKK12",
                     "name" : "Bath and North East Somerset, North Somerset and South Gloucestershire"
                  }
               },
               "lat" : 51.391294,
               "line" : null,
               "lng" : -2.393219,
               "postcode" : null,
               "primary" : false,
               "state" : null,
               "state_code" : null
            }
         ],
         "aliases" : [
            "Bath Institute of Medical Engineering"
         ],
         "country" : {
            "country_code" : "GB",
            "country_name" : "United Kingdom"
         },
         "email_address" : null,
         "established" : 1968,
         "external_ids" : {
            "GRID" : {
               "all" : "grid.486748.1",
               "preferred" : "grid.486748.1"
            },
            "ISNI" : {
               "all" : [
                  "0000 0004 0449 0078"
               ],
               "preferred" : null
            }
         },
         "id" : "https://ror.org/01datx010",
         "ip_addresses" : [],
         "labels" : [],
         "links" : [
            "http://www.designability.org.uk/"
         ],
         "name" : "Designability",
         "relationships" : [],
         "status" : "active",
         "types" : [
            "Nonprofit"
         ],
         "wikipedia_url" : "https://en.wikipedia.org/wiki/Bath_Institute_of_Medical_Engineering"
      },
      {
         "acronyms" : [
            "BBSP"
         ],
         "addresses" : [
            {
               "city" : "Bristol",
               "country_geonames_id" : 2635167,
               "geonames_city" : {
                  "city" : "Bristol",
                  "geonames_admin1" : {
                     "ascii_name" : "England",
                     "code" : "GB.ENG",
                     "id" : 6269131,
                     "name" : "England"
                  },
                  "geonames_admin2" : {
                     "ascii_name" : "City of Bristol",
                     "code" : "GB.ENG.B7",
                     "id" : 3333134,
                     "name" : "City of Bristol"
                  },
                  "id" : 2654675,
                  "license" : {
                     "attribution" : "Data from geonames.org under a CC-BY 3.0 license",
                     "license" : "http://creativecommons.org/licenses/by/3.0/"
                  },
                  "nuts_level1" : {
                     "code" : "UKK",
                     "name" : "SOUTH WEST (ENGLAND)"
                  },
                  "nuts_level2" : {
                     "code" : "UKK1",
                     "name" : "Gloucestershire, Wiltshire and Bristol/Bath area"
                  },
                  "nuts_level3" : {
                     "code" : "UKK12",
                     "name" : "Bath and North East Somerset, North Somerset and South Gloucestershire"
                  }
               },
               "lat" : 51.501223,
               "line" : null,
               "lng" : -2.478679,
               "postcode" : null,
               "primary" : false,
               "state" : null,
               "state_code" : null
            }
         ],
         "aliases" : [],
         "country" : {
            "country_code" : "GB",
            "country_name" : "United Kingdom"
         },
         "email_address" : null,
         "established" : 2011,
         "external_ids" : {
            "GRID" : {
               "all" : "grid.498158.9",
               "preferred" : "grid.498158.9"
            }
         },
         "id" : "https://ror.org/0105p2r38",
         "ip_addresses" : [],
         "labels" : [],
         "links" : [
            "https://www.bbsp.co.uk/"
         ],
         "name" : "Bristol and Bath Science Park",
         "relationships" : [],
         "status" : "active",
         "types" : [
            "Education"
         ],
         "wikipedia_url" : "https://en.wikipedia.org/wiki/Bristol_and_Bath_Science_Park"
      },
      {
         "acronyms" : [
            "BSDR"
         ],
         "addresses" : [
            {
               "city" : "Bath",
               "country_geonames_id" : 2635167,
               "geonames_city" : {
                  "city" : "Bath",
                  "geonames_admin1" : {
                     "ascii_name" : "England",
                     "code" : "GB.ENG",
                     "id" : 6269131,
                     "name" : "England"
                  },
                  "geonames_admin2" : {
                     "ascii_name" : "Bath and North East Somerset",
                     "code" : "GB.ENG.A4",
                     "id" : 3333123,
                     "name" : "Bath and North East Somerset"
                  },
                  "id" : 2656173,
                  "license" : {
                     "attribution" : "Data from geonames.org under a CC-BY 3.0 license",
                     "license" : "http://creativecommons.org/licenses/by/3.0/"
                  },
                  "nuts_level1" : {
                     "code" : "UKK",
                     "name" : "SOUTH WEST (ENGLAND)"
                  },
                  "nuts_level2" : {
                     "code" : "UKK1",
                     "name" : "Gloucestershire, Wiltshire and Bristol/Bath area"
                  },
                  "nuts_level3" : {
                     "code" : "UKK12",
                     "name" : "Bath and North East Somerset, North Somerset and South Gloucestershire"
                  }
               },
               "lat" : 51.387285,
               "line" : null,
               "lng" : -2.397273,
               "postcode" : null,
               "primary" : false,
               "state" : null,
               "state_code" : null
            }
         ],
         "aliases" : [],
         "country" : {
            "country_code" : "GB",
            "country_name" : "United Kingdom"
         },
         "email_address" : null,
         "established" : 2016,
         "external_ids" : {
            "GRID" : {
               "all" : "grid.499705.6",
               "preferred" : "grid.499705.6"
            }
         },
         "id" : "https://ror.org/02fzzq880",
         "ip_addresses" : [],
         "labels" : [],
         "links" : [
            "http://bathsdr.org/"
         ],
         "name" : "Bath Social and Development Research",
         "relationships" : [],
         "status" : "active",
         "types" : [
            "Nonprofit"
         ],
         "wikipedia_url" : ""
      },
      {
         "acronyms" : [
            "BRLSI"
         ],
         "addresses" : [
            {
               "city" : "Bath",
               "country_geonames_id" : 2635167,
               "geonames_city" : {
                  "city" : "Bath",
                  "geonames_admin1" : {
                     "ascii_name" : "England",
                     "code" : "GB.ENG",
                     "id" : 6269131,
                     "name" : "England"
                  },
                  "geonames_admin2" : {
                     "ascii_name" : "Bath and North East Somerset",
                     "code" : "GB.ENG.A4",
                     "id" : 3333123,
                     "name" : "Bath and North East Somerset"
                  },
                  "id" : 2656173,
                  "license" : {
                     "attribution" : "Data from geonames.org under a CC-BY 3.0 license",
                     "license" : "http://creativecommons.org/licenses/by/3.0/"
                  },
                  "nuts_level1" : {
                     "code" : 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" : 2635167,
               "geonames_city" : {
                  "city" : "Bath",
                  "geonames_admin1" : {
                     "ascii_name" : "England",
                     "code" : "GB.ENG",
                     "id" : 6269131,
                     "name" : "England"
                  },
                  "geonames_admin2" : {
                     "ascii_name" : "Bath and North East Somerset",
                     "code" : "GB.ENG.A4",
                     "id" : 3333123,
                     "name" : "Bath and North East Somerset"
                  },
                  "id" : 2656173,
                  "license" : {
                     "attribution" : "Data from geonames.org under a CC-BY 3.0 license",
                     "license" : "http://creativecommons.org/licenses/by/3.0/"
                  },
                  "nuts_level1" : {
                     "code" : "UKK",
                     "name" : "SOUTH WEST (ENGLAND)"
                  },
                  "nuts_level2" : {
                     "code" : "UKK1",
                     "name" : "Gloucestershire, Wiltshire and Bristol/Bath area"
                  },
                  "nuts_level3" : {
                     "code" : "UKK12",
                     "name" : "Bath and North East Somerset, North Somerset and South Gloucestershire"
                  }
               },
               "lat" : 51.391932,
               "line" : null,
               "lng" : -2.389183,
               "postcode" : null,
               "primary" : false,
               "state" : "Somerset",
               "state_code" : "GB-SOM"
            }
         ],
         "aliases" : [
            "Royal United Hospital Bath NHS Foundation Trust"
         ],
         "country" : {
            "country_code" : "GB",
            "country_name" : "United Kingdom"
         },
         "email_address" : null,
         "established" : 1864,
         "external_ids" : {
            "GRID" : {
               "all" : "grid.413029.d",
               "preferred" : "grid.413029.d"
            },
            "ISNI" : {
               "all" : [
                  "0000 0004 0374 2907"
               ],
               "preferred" : null
            },
            "OrgRef" : {
               "all" : [
                  "26346979"
               ],
               "preferred" : null
            },
            "Wikidata" : {
               "all" : [
                  "Q18162105"
               ],
               "preferred" : null
            }
         },
         "id" : "https://ror.org/058x7dy48",
         "ip_addresses" : [],
         "labels" : [],
         "links" : [
            "http://www.ruh.nhs.uk/"
         ],
         "name" : "Royal United Hospital Bath NHS Trust",
         "relationships" : [
            {
               "id" : "https://ror.org/05f9e0404",
               "label" : "Paulton Hospital",
               "type" : "Child"
            },
            {
               "id" : "https://ror.org/05va5gy74",
               "label" : "Royal National Hospital for Rheumatic Diseases",
               "type" : "Child"
            },
            {
               "id" : "https://ror.org/00a858n67",
               "label" : "Royal United Hospital",
               "type" : "Child"
            }
         ],
         "status" : "active",
         "types" : [
            "Healthcare"
         ],
         "wikipedia_url" : "https://en.wikipedia.org/wiki/Royal_United_Hospital_Bath_NHS_Foundation_Trust"
      },
      {
         "acronyms" : [],
         "addresses" : [
            {
               "city" : "Bath",
               "country_geonames_id" : 2635167,
               "geonames_city" : {
                  "city" : "Bath",
                  "geonames_admin1" : {
                     "ascii_name" : "England",
                     "code" : "GB.ENG",
                     "id" : 6269131,
                     "name" : "England"
                  },
                  "geonames_admin2" : {
                     "ascii_name" : "Bath and North East Somerset",
                     "code" : "GB.ENG.A4",
                     "id" : 3333123,
                     "name" : "Bath and North East Somerset"
                  },
                  "id" : 2656173,
                  "license" : {
                     "attribution" : "Data from geonames.org under a CC-BY 3.0 license",
                     "license" : "http://creativecommons.org/licenses/by/3.0/"
                  },
                  "nuts_level1" : {
                     "code" : "UKK",
                     "name" : "SOUTH WEST (ENGLAND)"
                  },
                  "nuts_level2" : {
                     "code" : "UKK1",
                     "name" : "Gloucestershire, Wiltshire and Bristol/Bath area"
                  },
                  "nuts_level3" : {
                     "code" : "UKK12",
                     "name" : "Bath and North East Somerset, North Somerset and South Gloucestershire"
                  }
               },
               "lat" : 51.415436,
               "line" : null,
               "lng" : -2.491173,
               "postcode" : null,
               "primary" : false,
               "state" : null,
               "state_code" : null
            }
         ],
         "aliases" : [],
         "country" : {
            "country_code" : "GB",
            "country_name" : "United Kingdom"
         },
         "email_address" : "",
         "established" : 1996,
         "external_ids" : {
            "GRID" : {
               "all" : "grid.450510.5",
               "preferred" : "grid.450510.5"
            },
            "ISNI" : {
               "all" : [
                  "0000 0004 0374 2966"
               ],
               "preferred" : null
            },
            "Wikidata" : {
               "all" : [
                  "Q16966588"
               ],
               "preferred" : null
            }
         },
         "id" : "https://ror.org/03rwxcx12",
         "ip_addresses" : [],
         "labels" : [],
         "links" : [
            "http://www.bathnes.gov.uk/"
         ],
         "name" : "Bath and North East Somerset Council",
         "relationships" : [],
         "status" : "active",
         "types" : [
            "Government"
         ],
         "wikipedia_url" : "https://en.wikipedia.org/wiki/Bath_and_North_East_Somerset_Council"
      },
      {
         "acronyms" : [
            "BaNES CCG"
         ],
         "addresses" : [
            {
               "city" : "Bath",
               "country_geonames_id" : 2635167,
               "geonames_city" : {
                  "city" : "Bath",
                  "geonames_admin1" : {
                     "ascii_name" : "England",
                     "code" : "GB.ENG",
                     "id" : 6269131,
                     "name" : "England"
                  },
                  "geonames_admin2" : {
                     "ascii_name" : "Bath and North East Somerset",
                     "code" : "GB.ENG.A4",
                     "id" : 3333123,
                     "name" : "Bath and North East Somerset"
                  },
                  "id" : 2656173,
                  "license" : {
                     "attribution" : "Data from geonames.org under a CC-BY 3.0 license",
                     "license" : "http://creativecommons.org/licenses/by/3.0/"
                  },
                  "nuts_level1" : {
                     "code" : "UKK",
                     "name" : "SOUTH WEST (ENGLAND)"
                  },
                  "nuts_level2" : {
                     "code" : "UKK1",
                     "name" : "Gloucestershire, Wiltshire and Bristol/Bath area"
                  },
                  "nuts_level3" : {
                     "code" : "UKK12",
                     "name" : "Bath and North East Somerset, North Somerset and South Gloucestershire"
                  }
               },
               "lat" : 51.35779,
               "line" : null,
               "lng" : -2.372919,
               "postcode" : null,
               "primary" : false,
               "state" : null,
               "state_code" : null
            }
         ],
         "aliases" : [],
         "country" : {
            "country_code" : "GB",
            "country_name" : "United Kingdom"
         },
         "email_address" : null,
         "established" : null,
         "external_ids" : {
            "GRID" : {
               "all" : "grid.476920.e",
               "preferred" : "grid.476920.e"
            }
         },
         "id" : "https://ror.org/00pkb6h65",
         "ip_addresses" : [],
         "labels" : [],
         "links" : [
            "http://www.bathandnortheastsomersetccg.nhs.uk/"
         ],
         "name" : "Bath and North East Somerset Clinical Commissioning Group",
         "relationships" : [],
         "status" : "active",
         "types" : [
            "Healthcare"
         ],
         "wikipedia_url" : ""
      },
      {
         "acronyms" : [],
         "addresses" : [
            {
               "city" : "Higashiosaka",
               "country_geonames_id" : 1861060,
               "geonames_city" : {
                  "city" : "Higashi-ōsaka",
                  "geonames_admin1" : {
                     "ascii_name" : "Osaka",
                     "code" : "JP.32",
                     "id" : 1853904,
                     "name" : "Ōsaka"
                  },
                  "geonames_admin2" : {
                     "ascii_name" : "Higashiosaka Shi",
                     "code" : "JP.32.1862751",
                     "id" : 1862751,
                     "name" : "Higashiōsaka Shi"
                  },
                  "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.6758,
               "line" : null,
               "lng" : 135.581458,
               "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" : [],
         "addresses" : [
            {
               "city" : "Sherman",
               "country_geonames_id" : 6252001,
               "geonames_city" : {
                  "city" : "Sherman",
                  "geonames_admin1" : {
                     "ascii_name" : "Texas",
                     "code" : "US.TX",
                     "id" : 4736286,
                     "name" : "Texas"
                  },
                  "geonames_admin2" : {
                     "ascii_name" : "Grayson County",
                     "code" : "US.TX.181",
                     "id" : 4694710,
                     "name" : "Grayson County"
                  },
                  "id" : 4728328,
                  "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.646309,
               "line" : null,
               "lng" : -96.594843,
               "postcode" : null,
               "primary" : false,
               "state" : "Texas",
               "state_code" : "US-TX"
            }
         ],
         "aliases" : [],
         "country" : {
            "country_code" : "US",
            "country_name" : "United States"
         },
         "email_address" : null,
         "established" : 1849,
         "external_ids" : {
            "GRID" : {
               "all" : "grid.423053.3",
               "preferred" : "grid.423053.3"
            },
            "ISNI" : {
               "all" : [
                  "0000 0004 0464 1366"
               ],
               "preferred" : null
            },
            "OrgRef" : {
               "all" : [
                  "575159"
               ],
               "preferred" : null
            },
            "Wikidata" : {
               "all" : [
                  "Q4823037"
               ],
               "preferred" : null
            }
         },
         "id" : "https://ror.org/052k56z27",
         "ip_addresses" : [],
         "labels" : [],
         "links" : [
            "http://www.austincollege.edu/"
         ],
         "name" : "Austin College",
         "relationships" : [],
         "status" : "active",
         "types" : [
            "Education"
         ],
         "wikipedia_url" : "https://en.wikipedia.org/wiki/Austin_College"
      },
      {
         "acronyms" : [],
         "addresses" : [
            {
               "city" : "Olds",
               "country_geonames_id" : 6251999,
               "geonames_city" : {
                  "city" : "Olds",
                  "geonames_admin1" : {
                     "ascii_name" : "Alberta",
                     "code" : "CA.01",
                     "id" : 5883102,
                     "name" : "Alberta"
                  },
                  "geonames_admin2" : {
                     "ascii_name" : null,
                     "code" : null,
                     "id" : null,
                     "name" : null
                  },
                  "id" : 6093347,
                  "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.79015,
               "line" : null,
               "lng" : -114.09538,
               "postcode" : null,
               "primary" : false,
               "state" : "Alberta",
               "state_code" : "CA-AB"
            }
         ],
         "aliases" : [],
         "country" : {
            "country_code" : "CA",
            "country_name" : "Canada"
         },
         "email_address" : "",
         "established" : 1913,
         "external_ids" : {
            "GRID" : {
               "all" : "grid.423088.5",
               "preferred" : "grid.423088.5"
            },
            "ISNI" : {
               "all" : [
                  "0000 0000 9197 8231"
               ],
               "preferred" : null
            },
            "OrgRef" : {
               "all" : [
                  "1916513"
               ],
               "preferred" : null
            },
            "Wikidata" : {
               "all" : [
                  "Q7085725"
               ],
               "preferred" : null
            }
         },
         "id" : "https://ror.org/04rxjcv17",
         "ip_addresses" : [],
         "labels" : [],
         "links" : [
            "http://www.oldscollege.ca/"
         ],
         "name" : "Olds College",
         "relationships" : [],
         "status" : "active",
         "types" : [
            "Education"
         ],
         "wikipedia_url" : "http://en.wikipedia.org/wiki/Olds_College"
      },
      {
         "acronyms" : [],
         "addresses" : [
            {
               "city" : "Bloomfield",
               "country_geonames_id" : 6252001,
               "geonames_city" : {
                  "city" : "Bloomfield",
                  "geonames_admin1" : {
                     "ascii_name" : "New Jersey",
                     "code" : "US.NJ",
                     "id" : 5101760,
                     "name" : "New Jersey"
                  },
                  "geonames_admin2" : {
                     "ascii_name" : "Essex County",
                     "code" : "US.NJ.013",
                     "id" : 5097707,
                     "name" : "Essex County"
                  },
                  "id" : 5095779,
                  "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.795577,
               "line" : null,
               "lng" : -74.195511,
               "postcode" : null,
               "primary" : false,
               "state" : "New Jersey",
               "state_code" : "US-NJ"
            }
         ],
         "aliases" : [],
         "country" : {
            "country_code" : "US",
            "country_name" : "United States"
         },
         "email_address" : null,
         "established" : 1868,
         "external_ids" : {
            "GRID" : {
               "all" : "grid.423092.e",
               "preferred" : "grid.423092.e"
            },
            "ISNI" : {
               "all" : [
                  "0000 0001 0288 8419"
               ],
               "preferred" : null
            },
            "OrgRef" : {
               "all" : [
                  "295111"
               ],
               "preferred" : null
            },
            "Wikidata" : {
               "all" : [
                  "Q4928235"
               ],
               "preferred" : null
            }
         },
         "id" : "https://ror.org/04gdk0x87",
         "ip_addresses" : [],
         "labels" : [],
         "links" : [
            "http://www.bloomfield.edu/"
         ],
         "name" : "Bloomfield College",
         "relationships" : [],
         "status" : "active",
         "types" : [
            "Education"
         ],
         "wikipedia_url" : "https://en.wikipedia.org/wiki/Bloomfield_College"
      },
      {
         "acronyms" : [],
         "addresses" : [
            {
               "city" : "Muskogee",
               "country_geonames_id" : 6252001,
               "geonames_city" : {
                  "city" : "Muskogee",
                  "geonames_admin1" : {
                     "ascii_name" : "Oklahoma",
                     "code" : "US.OK",
                     "id" : 4544379,
                     "name" : "Oklahoma"
                  },
                  "geonames_admin2" : {
                     "ascii_name" : "Muskogee County",
                     "code" : "US.OK.101",
                     "id" : 4543342,
                     "name" : "Muskogee County"
                  },
                  "id" : 4543338,
                  "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" : 35.777721,
               "line" : null,
               "lng" : -95.335088,
               "postcode" : null,
               "primary" : false,
               "state" : "Oklahoma",
               "state_code" : "US-OK"
            }
         ],
         "aliases" : [],
         "country" : {
            "country_code" : "US",
            "country_name" : "United States"
         },
         "email_address" : null,
         "established" : 1880,
         "external_ids" : {
            "GRID" : {
               "all" : "grid.423155.4",
               "preferred" : "grid.423155.4"
            },
            "ISNI" : {
               "all" : [
                  "0000 0001 0423 2392"
               ],
               "preferred" : null
            },
            "OrgRef" : {
               "all" : [
                  "6330370"
               ],
               "preferred" : null
            },
            "Wikidata" : {
               "all" : [
                  "Q2878449"
               ],
               "preferred" : null
            }
         },
         "id" : "https://ror.org/03rvph505",
         "ip_addresses" : [],
         "labels" : [],
         "links" : [
            "http://www.bacone.edu/"
         ],
         "name" : "Bacone College",
         "relationships" : [],
         "status" : "active",
         "types" : [
            "Education"
         ],
         "wikipedia_url" : "https://en.wikipedia.org/wiki/Bacone_College"
      }
   ],
   "meta" : {
      "countries" : [
         {
            "count" : 2104,
            "id" : "us",
            "title" : "United States"
         },
         {
            "count" : 367,
            "id" : "in",
            "title" : "India"
         },
         {
            "count" : 361,
            "id" : "jp",
            "title" : "Japan"
         },
         {
            "count" : 330,
            "id" : "gb",
            "title" : "United Kingdom"
         },
         {
            "count" : 270,
            "id" : "cn",
            "title" : "China"
         },
         {
            "count" : 159,
            "id" : "ca",
            "title" : "Canada"
         },
         {
            "count" : 108,
            "id" : "ph",
            "title" : "Philippines"
         },
         {
            "count" : 61,
            "id" : "kr",
            "title" : "South Korea"
         },
         {
            "count" : 52,
            "id" : "au",
            "title" : "Australia"
         },
         {
            "count" : 47,
            "id" : "pk",
            "title" : "Pakistan"
         }
      ],
      "statuses" : [
         {
            "count" : 4608,
            "id" : "active",
            "title" : "active"
         }
      ],
      "types" : [
         {
            "count" : 4303,
            "id" : "education",
            "title" : "Education"
         },
         {
            "count" : 177,
            "id" : "healthcare",
            "title" : "Healthcare"
         },
         {
            "count" : 60,
            "id" : "nonprofit",
            "title" : "Nonprofit"
         },
         {
            "count" : 44,
            "id" : "other",
            "title" : "Other"
         },
         {
            "count" : 14,
            "id" : "facility",
            "title" : "Facility"
         },
         {
            "count" : 4,
            "id" : "government",
            "title" : "Government"
         },
         {
            "count" : 3,
            "id" : "archive",
            "title" : "Archive"
         },
         {
            "count" : 3,
            "id" : "company",
            "title" : "Company"
         }
      ]
   },
   "number_of_results" : 4608,
   "time_taken" : 13
}

🚧

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/organizations?query=%22Bath%20College%22'

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" : 2635167,
               "geonames_city" : {
                  "city" : "Bath",
                  "geonames_admin1" : {
                     "ascii_name" : "England",
                     "code" : "GB.ENG",
                     "id" : 6269131,
                     "name" : "England"
                  },
                  "geonames_admin2" : {
                     "ascii_name" : "Bath and North East Somerset",
                     "code" : "GB.ENG.A4",
                     "id" : 3333123,
                     "name" : "Bath and North East Somerset"
                  },
                  "id" : 2656173,
                  "license" : {
                     "attribution" : "Data from geonames.org under a CC-BY 3.0 license",
                     "license" : "http://creativecommons.org/licenses/by/3.0/"
                  },
                  "nuts_level1" : {
                     "code" : "UKK",
                     "name" : "SOUTH WEST (ENGLAND)"
                  },
                  "nuts_level2" : {
                     "code" : "UKK1",
                     "name" : "Gloucestershire, Wiltshire and Bristol/Bath area"
                  },
                  "nuts_level3" : {
                     "code" : "UKK12",
                     "name" : "Bath and North East Somerset, North Somerset and South Gloucestershire"
                  }
               },
               "lat" : 51.380148,
               "line" : null,
               "lng" : -2.362725,
               "postcode" : null,
               "primary" : false,
               "state" : null,
               "state_code" : null
            }
         ],
         "aliases" : [],
         "country" : {
            "country_code" : "GB",
            "country_name" : "United Kingdom"
         },
         "email_address" : null,
         "established" : 1892,
         "external_ids" : {
            "GRID" : {
               "all" : "grid.468747.e",
               "preferred" : "grid.468747.e"
            },
            "ISNI" : {
               "all" : [
                  "0000 0004 6437 268X"
               ],
               "preferred" : null
            },
            "OrgRef" : {
               "all" : [
                  "11933767"
               ],
               "preferred" : null
            },
            "Wikidata" : {
               "all" : [
                  "Q5123579"
               ],
               "preferred" : null
            }
         },
         "id" : "https://ror.org/00pbyj886",
         "ip_addresses" : [],
         "labels" : [],
         "links" : [
            "https://www.bathcollege.ac.uk/"
         ],
         "name" : "Bath College",
         "relationships" : [],
         "status" : "active",
         "types" : [
            "Education"
         ],
         "wikipedia_url" : "https://en.wikipedia.org/wiki/Bath_College"
      },
      {
         "acronyms" : [],
         "addresses" : [
            {
               "city" : "Bath",
               "country_geonames_id" : 2635167,
               "geonames_city" : {
                  "city" : "Bath",
                  "geonames_admin1" : {
                     "ascii_name" : "England",
                     "code" : "GB.ENG",
                     "id" : 6269131,
                     "name" : "England"
                  },
                  "geonames_admin2" : {
                     "ascii_name" : "Bath and North East Somerset",
                     "code" : "GB.ENG.A4",
                     "id" : 3333123,
                     "name" : "Bath and North East Somerset"
                  },
                  "id" : 2656173,
                  "license" : {
                     "attribution" : "Data from geonames.org under a CC-BY 3.0 license",
                     "license" : "http://creativecommons.org/licenses/by/3.0/"
                  },
                  "nuts_level1" : {
                     "code" : "UKK",
                     "name" : "SOUTH WEST (ENGLAND)"
                  },
                  "nuts_level2" : {
                     "code" : "UKK1",
                     "name" : "Gloucestershire, Wiltshire and Bristol/Bath area"
                  },
                  "nuts_level3" : {
                     "code" : "UKK12",
                     "name" : "Bath and North East Somerset, North Somerset and South Gloucestershire"
                  }
               },
               "lat" : 51.37598,
               "line" : null,
               "lng" : -2.438833,
               "postcode" : null,
               "primary" : false,
               "state" : "Bath and North East Somerset",
               "state_code" : "GB-BAS"
            }
         ],
         "aliases" : [
            "Bath College of Higher Education",
            "Bath Spa University College"
         ],
         "country" : {
            "country_code" : "GB",
            "country_name" : "United Kingdom"
         },
         "email_address" : null,
         "established" : 2005,
         "external_ids" : {
            "FundRef" : {
               "all" : [
                  "100010331"
               ],
               "preferred" : null
            },
            "GRID" : {
               "all" : "grid.252874.e",
               "preferred" : "grid.252874.e"
            },
            "HESA" : {
               "all" : [
                  "0048"
               ],
               "preferred" : null
            },
            "ISNI" : {
               "all" : [
                  "0000 0001 2034 9451"
               ],
               "preferred" : null
            },
            "OrgRef" : {
               "all" : [
                  "818426"
               ],
               "preferred" : null
            },
            "UCAS" : {
               "all" : [
                  "B20"
               ],
               "preferred" : null
            },
            "UKPRN" : {
               "all" : [
                  "10000571"
               ],
               "preferred" : null
            },
            "Wikidata" : {
               "all" : [
                  "Q3091754"
               ],
               "preferred" : null
            }
         },
         "id" : "https://ror.org/0038jbq24",
         "ip_addresses" : [],
         "labels" : [],
         "links" : [
            "https://www.bathspa.ac.uk/"
         ],
         "name" : "Bath Spa University",
         "relationships" : [],
         "status" : "active",
         "types" : [
            "Education"
         ],
         "wikipedia_url" : "http://en.wikipedia.org/wiki/Bath_Spa_University"
      }
   ],
   "meta" : {
      "countries" : [
         {
            "count" : 2,
            "id" : "gb",
            "title" : "United Kingdom"
         }
      ],
      "statuses" : [
         {
            "count" : 2,
            "id" : "active",
            "title" : "active"
         }
      ],
      "types" : [
         {
            "count" : 2,
            "id" : "education",
            "title" : "Education"
         }
      ]
   },
   "number_of_results" : 2,
   "time_taken" : 40
}

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/organizations?query=%22Franklin%20%26%20Marshall%20College%22'

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" : 6252001,
               "geonames_city" : {
                  "city" : "Lancaster",
                  "geonames_admin1" : {
                     "ascii_name" : "Pennsylvania",
                     "code" : "US.PA",
                     "id" : 6254927,
                     "name" : "Pennsylvania"
                  },
                  "geonames_admin2" : {
                     "ascii_name" : "Lancaster",
                     "code" : "US.PA.071",
                     "id" : 5197085,
                     "name" : "Lancaster"
                  },
                  "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"
            },
            "OrgRef" : {
               "all" : [
                  "2163518"
               ],
               "preferred" : null
            },
            "Wikidata" : {
               "all" : [
                  "Q664881"
               ],
               "preferred" : null
            }
         },
         "id" : "https://ror.org/04fp4ps48",
         "ip_addresses" : [],
         "labels" : [],
         "links" : [
            "http://www.fandm.edu/"
         ],
         "name" : "Franklin & Marshall College",
         "relationships" : [],
         "status" : "active",
         "types" : [
            "Education"
         ],
         "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"
         }
      ]
   },
   "number_of_results" : 1,
   "time_taken" : 46
}

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.

Example

Search for the GRID ID of the U.S. Department of Energy.

curl 'https://api.ror.org/organizations?query=%22grid.453259.c%22'

The response returns a single record for the U.S. Department of Energy that contains the searched-for identifier in external_ids.

{
   "items" : [
      {
         "acronyms" : [
            "FE"
         ],
         "addresses" : [
            {
               "city" : "Washington D.C.",
               "country_geonames_id" : 6252001,
               "geonames_city" : {
                  "city" : "Washington, D.C.",
                  "geonames_admin1" : {
                     "ascii_name" : "Washington, D.C.",
                     "code" : "US.DC",
                     "id" : 4138106,
                     "name" : "Washington, D.C."
                  },
                  "geonames_admin2" : {
                     "ascii_name" : "Washington County",
                     "code" : "US.DC.001",
                     "id" : 4140987,
                     "name" : "Washington County"
                  },
                  "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.887022,
               "line" : null,
               "lng" : -77.025954,
               "postcode" : null,
               "primary" : false,
               "state" : "District of Columbia",
               "state_code" : "US-DC"
            }
         ],
         "aliases" : [],
         "country" : {
            "country_code" : "US",
            "country_name" : "United States"
         },
         "email_address" : null,
         "established" : 1900,
         "external_ids" : {
            "FundRef" : {
               "all" : [
                  "100006120",
                  "100006164"
               ],
               "preferred" : "100006120"
            },
            "GRID" : {
               "all" : "grid.453259.c",
               "preferred" : "grid.453259.c"
            },
            "ISNI" : {
               "all" : [
                  "0000 0001 2215 6856"
               ],
               "preferred" : null
            }
         },
         "id" : "https://ror.org/03ery9d53",
         "ip_addresses" : [],
         "labels" : [],
         "links" : [
            "http://energy.gov/fe/office-fossil-energy"
         ],
         "name" : "Office of Fossil Energy",
         "relationships" : [
            {
               "id" : "https://ror.org/01bj3aw27",
               "label" : "United States Department of Energy",
               "type" : "Parent"
            }
         ],
         "status" : "active",
         "types" : [
            "Government"
         ],
         "wikipedia_url" : ""
      }
   ],
   "meta" : {
      "countries" : [
         {
            "count" : 1,
            "id" : "us",
            "title" : "United States"
         }
      ],
      "statuses" : [
         {
            "count" : 1,
            "id" : "active",
            "title" : "active"
         }
      ],
      "types" : [
         {
            "count" : 1,
            "id" : "government",
            "title" : "Government"
         }
      ]
   },
   "number_of_results" : 1,
   "time_taken" : 6
}

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/organizations?query=Harvard&page=2&all_status'

The response returns the second page of results of a keyword search for "Harvard" that includes records of all status types.

{
   "items" : [
      {
         "acronyms" : [
            "HAEMR"
         ],
         "addresses" : [
            {
               "city" : "Boston",
               "country_geonames_id" : 6252001,
               "geonames_city" : {
                  "city" : "Boston",
                  "geonames_admin1" : {
                     "ascii_name" : "Massachusetts",
                     "code" : "US.MA",
                     "id" : 6254926,
                     "name" : "Massachusetts"
                  },
                  "geonames_admin2" : {
                     "ascii_name" : "Suffolk County",
                     "code" : "US.MA.025",
                     "id" : 4952349,
                     "name" : "Suffolk County"
                  },
                  "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.335946,
               "line" : null,
               "lng" : -71.107469,
               "postcode" : null,
               "primary" : false,
               "state" : "Massachusetts",
               "state_code" : "US-MA"
            }
         ],
         "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" : ""
      },
      {
         "acronyms" : [
            "CfA"
         ],
         "addresses" : [
            {
               "city" : "Cambridge",
               "country_geonames_id" : 6252001,
               "geonames_city" : {
                  "city" : "Cambridge",
                  "geonames_admin1" : {
                     "ascii_name" : "Massachusetts",
                     "code" : "US.MA",
                     "id" : 6254926,
                     "name" : "Massachusetts"
                  },
                  "geonames_admin2" : {
                     "ascii_name" : "Middlesex County",
                     "code" : "US.MA.017",
                     "id" : 4943909,
                     "name" : "Middlesex County"
                  },
                  "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.381463,
               "line" : null,
               "lng" : -71.128166,
               "postcode" : null,
               "primary" : false,
               "state" : "Massachusetts",
               "state_code" : "US-MA"
            }
         ],
         "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"
            },
            "OrgRef" : {
               "all" : [
                  "1505128"
               ],
               "preferred" : null
            },
            "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/03vek6s52",
               "label" : "Harvard University",
               "type" : "Parent"
            },
            {
               "id" : "https://ror.org/01pp8nd67",
               "label" : "Smithsonian Institution",
               "type" : "Parent"
            },
            {
               "id" : "https://ror.org/01mcvy510",
               "label" : "Harvard College Observatory",
               "type" : "Child"
            },
            {
               "id" : "https://ror.org/04mh52z70",
               "label" : "Smithsonian Astrophysical Observatory",
               "type" : "Child"
            }
         ],
         "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" : 933860,
               "geonames_city" : {
                  "city" : "Gaborone",
                  "geonames_admin1" : {
                     "ascii_name" : "Gaborone",
                     "code" : "BW.14",
                     "id" : 11778169,
                     "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.65661,
               "line" : null,
               "lng" : 25.923299,
               "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" : [
            "http://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" : ""
      },
      {
         "acronyms" : [
            "DF/HCC"
         ],
         "addresses" : [
            {
               "city" : "Boston",
               "country_geonames_id" : 6252001,
               "geonames_city" : {
                  "city" : "Boston",
                  "geonames_admin1" : {
                     "ascii_name" : "Massachusetts",
                     "code" : "US.MA",
                     "id" : 6254926,
                     "name" : "Massachusetts"
                  },
                  "geonames_admin2" : {
                     "ascii_name" : "Suffolk",
                     "code" : "US.MA.025",
                     "id" : 4952349,
                     "name" : "Suffolk"
                  },
                  "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
            }
         },
         "id" : "https://ror.org/03pvyf116",
         "ip_addresses" : [],
         "labels" : [],
         "links" : [
            "http://www.dfhcc.harvard.edu/"
         ],
         "name" : "Dana-Farber/Harvard Cancer Center",
         "relationships" : [],
         "status" : "active",
         "types" : [
            "Healthcare"
         ],
         "wikipedia_url" : ""
      },
      {
         "acronyms" : [],
         "addresses" : [
            {
               "city" : "Boston",
               "country_geonames_id" : 6252001,
               "geonames_city" : {
                  "city" : "Boston",
                  "geonames_admin1" : {
                     "ascii_name" : "Massachusetts",
                     "code" : "US.MA",
                     "id" : 6254926,
                     "name" : "Massachusetts"
                  },
                  "geonames_admin2" : {
                     "ascii_name" : "Suffolk",
                     "code" : "US.MA.025",
                     "id" : 4952349,
                     "name" : "Suffolk"
                  },
                  "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"
         ],
         "wikipedia_url" : "https://en.wikipedia.org/wiki/Arnold_Arboretum"
      },
      {
         "acronyms" : [
            "CUA"
         ],
         "addresses" : [
            {
               "city" : "Cambridge",
               "country_geonames_id" : 6252001,
               "geonames_city" : {
                  "city" : "Cambridge",
                  "geonames_admin1" : {
                     "ascii_name" : "Massachusetts",
                     "code" : "US.MA",
                     "id" : 6254926,
                     "name" : "Massachusetts"
                  },
                  "geonames_admin2" : {
                     "ascii_name" : "Middlesex",
                     "code" : "US.MA.017",
                     "id" : 4943909,
                     "name" : "Middlesex"
                  },
                  "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"
         ],
         "wikipedia_url" : ""
      },
      {
         "acronyms" : [],
         "addresses" : [
            {
               "city" : "Cambridge",
               "country_geonames_id" : 6252001,
               "geonames_city" : {
                  "city" : "Cambridge",
                  "geonames_admin1" : {
                     "ascii_name" : "Massachusetts",
                     "code" : "US.MA",
                     "id" : 6254926,
                     "name" : "Massachusetts"
                  },
                  "geonames_admin2" : {
                     "ascii_name" : "Middlesex",
                     "code" : "US.MA.017",
                     "id" : 4943909,
                     "name" : "Middlesex"
                  },
                  "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" : "",
         "established" : 2004,
         "external_ids" : {
            "FundRef" : {
               "all" : [
                  "100013114"
               ],
               "preferred" : "100013114"
            },
            "GRID" : {
               "all" : "grid.66859.34",
               "preferred" : "grid.66859.34"
            },
            "OrgRef" : {
               "all" : [
                  "2447768"
               ],
               "preferred" : null
            },
            "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/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"
         ],
         "wikipedia_url" : "http://en.wikipedia.org/wiki/Broad_Institute"
      },
      {
         "acronyms" : [],
         "addresses" : [
            {
               "city" : "Cambridge",
               "country_geonames_id" : 6252001,
               "geonames_city" : {
                  "city" : "Cambridge",
                  "geonames_admin1" : {
                     "ascii_name" : "Massachusetts",
                     "code" : "US.MA",
                     "id" : 6254926,
                     "name" : "Massachusetts"
                  },
                  "geonames_admin2" : {
                     "ascii_name" : "Middlesex",
                     "code" : "US.MA.017",
                     "id" : 4943909,
                     "name" : "Middlesex"
                  },
                  "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" : [
            "Ragon Institute of Massachusetts General Hospital, Massachusetts Institute of Technology and Harvard University",
            "Phillip T. and Susan M. Ragon Institute"
         ],
         "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"
         ],
         "wikipedia_url" : "https://en.wikipedia.org/wiki/Phillip_T._and_Susan_M._Ragon_Institute"
      },
      {
         "acronyms" : [
            "HST"
         ],
         "addresses" : [
            {
               "city" : "Cambridge",
               "country_geonames_id" : 6252001,
               "geonames_city" : {
                  "city" : "Cambridge",
                  "geonames_admin1" : {
                     "ascii_name" : "Massachusetts",
                     "code" : "US.MA",
                     "id" : 6254926,
                     "name" : "Massachusetts"
                  },
                  "geonames_admin2" : {
                     "ascii_name" : "Middlesex County",
                     "code" : "US.MA.017",
                     "id" : 4943909,
                     "name" : "Middlesex County"
                  },
                  "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.361777,
               "line" : null,
               "lng" : -71.086911,
               "postcode" : null,
               "primary" : false,
               "state" : "Massachusetts",
               "state_code" : "US-MA"
            }
         ],
         "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
            },
            "OrgRef" : {
               "all" : [
                  "4391692"
               ],
               "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" : 2921044,
               "geonames_city" : {
                  "city" : "Jena",
                  "geonames_admin1" : {
                     "ascii_name" : "Thuringia",
                     "code" : "DE.15",
                     "id" : 2822542,
                     "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" : "DEG",
                     "name" : "THÜRINGEN"
                  },
                  "nuts_level2" : {
                     "code" : "DEG0",
                     "name" : "Thüringen"
                  },
                  "nuts_level3" : {
                     "code" : "DEG03",
                     "name" : "Jena, Kreisfreie Stadt"
                  }
               },
               "lat" : 50.927222,
               "line" : null,
               "lng" : 11.586111,
               "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" : 26,
            "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" : 28,
            "id" : "active",
            "title" : "active"
         },
         {
            "count" : 1,
            "id" : "inactive",
            "title" : "inactive"
         },
         {
            "count" : 1,
            "id" : "withdrawn",
            "title" : "withdrawn"
         }
      ],
      "types" : [
         {
            "count" : 6,
            "id" : "facility",
            "title" : "Facility"
         },
         {
            "count" : 6,
            "id" : "other",
            "title" : "Other"
         },
         {
            "count" : 5,
            "id" : "education",
            "title" : "Education"
         },
         {
            "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" : 30,
   "time_taken" : 3
}

Example

curl 'https://api.ror.org/organizations?query=Technology&filter=country.country_name:Jordan'

The response returns a list of research organizations in the country of Jordan whose names include the keyword "Technology."

{
  "number_of_results": 3,
  "time_taken": 4,
  "items": [
    {
      "id": "https://ror.org/01jy46q10",
      "name": "Princess Sumaya University for Technology",
      "email_address": "",
      "ip_addresses": [],
      "established": 1991,
      "types": [
        "Education"
      ],
      "relationships": [],
      "addresses": [
        {
          "lat": 32.023056,
          "lng": 35.876389,
          "state": null,
          "state_code": null,
          "city": "Amman",
          "geonames_city": {
            "id": 250441,
            "city": "Amman",
            "geonames_admin1": {
              "name": "Amman",
              "id": 250439,
              "ascii_name": "Amman",
              "code": "JO.16"
            },
            "geonames_admin2": {
              "name": null,
              "id": null,
              "ascii_name": null,
              "code": null
            },
            "license": {
              "attribution": "Data from geonames.org under a CC-BY 3.0 license",
              "license": "http://creativecommons.org/licenses/by/3.0/"
            },
            "nuts_level1": {
              "name": null,
              "code": null
            },
            "nuts_level2": {
              "name": null,
              "code": null
            },
            "nuts_level3": {
              "name": null,
              "code": null
            }
          },
          "postcode": null,
          "primary": false,
          "line": null,
          "country_geonames_id": 248816
        }
      ],
      "links": [
        "http://psut.edu.jo/main/"
      ],
      "aliases": [],
      "acronyms": [
        "PSUT"
      ],
      "status": "active",
      "wikipedia_url": "http://en.wikipedia.org/wiki/Princess_Sumaya_University_for_Technology",
      "labels": [
        {
          "label": "جامعة الأميرة سمية للتكنولوجيا",
          "iso639": "ar"
        }
      ],
      "country": {
        "country_name": "Jordan",
        "country_code": "JO"
      },
      "external_ids": {
        "ISNI": {
          "preferred": null,
          "all": [
            "0000 0004 0404 9637"
          ]
        },
        "OrgRef": {
          "preferred": null,
          "all": [
            "1970157"
          ]
        },
        "Wikidata": {
          "preferred": null,
          "all": [
            "Q3551722"
          ]
        },
        "GRID": {
          "preferred": "grid.29251.3d",
          "all": "grid.29251.3d"
        }
      }
    },
    {
      "id": "https://ror.org/05bhjm183",
      "name": "Higher Council for Science and Technology",
      "email_address": null,
      "ip_addresses": [],
      "established": 1987,
      "types": [
        "Other"
      ],
      "relationships": [],
      "addresses": [
        {
          "lat": 32.01071,
          "lng": 35.89802,
          "state": null,
          "state_code": null,
          "city": "Al Jubayhah",
          "geonames_city": {
            "id": 250637,
            "city": "Al Jubayhah",
            "geonames_admin1": {
              "name": "Amman",
              "id": 250439,
              "ascii_name": "Amman",
              "code": "JO.16"
            },
            "geonames_admin2": {
              "name": null,
              "id": null,
              "ascii_name": null,
              "code": null
            },
            "license": {
              "attribution": "Data from geonames.org under a CC-BY 3.0 license",
              "license": "http://creativecommons.org/licenses/by/3.0/"
            },
            "nuts_level1": {
              "name": null,
              "code": null
            },
            "nuts_level2": {
              "name": null,
              "code": null
            },
            "nuts_level3": {
              "name": null,
              "code": null
            }
          },
          "postcode": null,
          "primary": false,
          "line": null,
          "country_geonames_id": 248816
        }
      ],
      "links": [
        "http://hcst.gov.jo/"
      ],
      "aliases": [],
      "acronyms": [
        "HCST"
      ],
      "status": "active",
      "wikipedia_url": "",
      "labels": [],
      "country": {
        "country_name": "Jordan",
        "country_code": "JO"
      },
      "external_ids": {
        "FundRef": {
          "preferred": "501100010300",
          "all": [
            "501100010300"
          ]
        },
        "GRID": {
          "preferred": "grid.438384.0",
          "all": "grid.438384.0"
        }
      }
    },
    {
      "id": "https://ror.org/03y8mtb59",
      "name": "Jordan University of Science and Technology",
      "email_address": null,
      "ip_addresses": [],
      "established": 1986,
      "types": [
        "Education"
      ],
      "relationships": [
        {
          "label": "King Abdullah University Hospital",
          "type": "Related",
          "id": "https://ror.org/02f6hdc06"
        },
        {
          "label": "Specialty Hospital, Jordan",
          "type": "Related",
          "id": "https://ror.org/01fafm680"
        }
      ],
      "addresses": [
        {
          "lat": 32.55556,
          "lng": 35.85,
          "state": null,
          "state_code": null,
          "city": "Irbid",
          "geonames_city": {
            "id": 248946,
            "city": "Irbid",
            "geonames_admin1": {
              "name": "Irbid",
              "id": 248944,
              "ascii_name": "Irbid",
              "code": "JO.18"
            },
            "geonames_admin2": {
              "name": null,
              "id": null,
              "ascii_name": null,
              "code": null
            },
            "license": {
              "attribution": "Data from geonames.org under a CC-BY 3.0 license",
              "license": "http://creativecommons.org/licenses/by/3.0/"
            },
            "nuts_level1": {
              "name": null,
              "code": null
            },
            "nuts_level2": {
              "name": null,
              "code": null
            },
            "nuts_level3": {
              "name": null,
              "code": null
            }
          },
          "postcode": null,
          "primary": false,
          "line": null,
          "country_geonames_id": 248816
        }
      ],
      "links": [
        "http://www.just.edu.jo/Pages/Default.aspx"
      ],
      "aliases": [],
      "acronyms": [
        "JUST"
      ],
      "status": "active",
      "wikipedia_url": "http://en.wikipedia.org/wiki/Jordan_University_of_Science_and_Technology",
      "labels": [
        {
          "label": "جامعة العلوم والتكنولوجيا الأردنية",
          "iso639": "ar"
        }
      ],
      "country": {
        "country_name": "Jordan",
        "country_code": "JO"
      },
      "external_ids": {
        "ISNI": {
          "preferred": null,
          "all": [
            "0000 0001 0097 5797"
          ]
        },
        "FundRef": {
          "preferred": null,
          "all": [
            "501100004035",
            "501100019004"
          ]
        },
        "OrgRef": {
          "preferred": null,
          "all": [
            "4821140"
          ]
        },
        "Wikidata": {
          "preferred": null,
          "all": [
            "Q2919325"
          ]
        },
        "GRID": {
          "preferred": "grid.37553.37",
          "all": "grid.37553.37"
        }
      }
    }
  ],
  "meta": {
    "types": [
      {
        "id": "education",
        "title": "Education",
        "count": 2
      },
      {
        "id": "other",
        "title": "Other",
        "count": 1
      }
    ],
    "countries": [
      {
        "id": "jo",
        "title": "Jordan",
        "count": 3
      }
    ],
    "statuses": [
      {
        "id": "active",
        "title": "active",
        "count": 3
      }
    ]
  }
}

Example

curl 'https://api.ror.org/organizations?query=Bath&filter=types:Facility,country.country_code:GB'

The response returns a single research facility in Great Britain whose name contains the keyword "Bath".

{
   "items" : [
      {
         "acronyms" : [],
         "addresses" : [
            {
               "city" : "Bath",
               "country_geonames_id" : 2635167,
               "geonames_city" : {
                  "city" : "Bath",
                  "geonames_admin1" : {
                     "ascii_name" : "England",
                     "code" : "GB.ENG",
                     "id" : 6269131,
                     "name" : "England"
                  },
                  "geonames_admin2" : {
                     "ascii_name" : "Bath and North East Somerset",
                     "code" : "GB.ENG.A4",
                     "id" : 3333123,
                     "name" : "Bath and North East Somerset"
                  },
                  "id" : 2656173,
                  "license" : {
                     "attribution" : "Data from geonames.org under a CC-BY 3.0 license",
                     "license" : "http://creativecommons.org/licenses/by/3.0/"
                  },
                  "nuts_level1" : {
                     "code" : "UKK",
                     "name" : "SOUTH WEST (ENGLAND)"
                  },
                  "nuts_level2" : {
                     "code" : "UKK1",
                     "name" : "Gloucestershire, Wiltshire and Bristol/Bath area"
                  },
                  "nuts_level3" : {
                     "code" : "UKK12",
                     "name" : "Bath and North East Somerset, North Somerset and South Gloucestershire"
                  }
               },
               "lat" : 51.386501,
               "line" : null,
               "lng" : -2.364442,
               "postcode" : null,
               "primary" : false,
               "state" : null,
               "state_code" : null
            }
         ],
         "aliases" : [],
         "country" : {
            "country_code" : "GB",
            "country_name" : "United Kingdom"
         },
         "email_address" : null,
         "established" : 2003,
         "external_ids" : {
            "GRID" : {
               "all" : "grid.432411.1",
               "preferred" : "grid.432411.1"
            }
         },
         "id" : "https://ror.org/04hf68923",
         "ip_addresses" : [],
         "labels" : [],
         "links" : [
            "http://www.bathlabs.com/"
         ],
         "name" : "Bath Labs",
         "relationships" : [],
         "status" : "active",
         "types" : [
            "Facility"
         ],
         "wikipedia_url" : ""
      }
   ],
   "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" : 4
}

Example

curl 'https://api.ror.org/organizations?query=Osaka&filter=status:inactive,country.country_name:Japan'

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" : 1861060,
               "geonames_city" : {
                  "city" : "Osaka",
                  "geonames_admin1" : {
                     "ascii_name" : "Ōsaka",
                     "code" : "JP.32",
                     "id" : 1853904,
                     "name" : "Ōsaka"
                  },
                  "geonames_admin2" : {
                     "ascii_name" : "Osaka City",
                     "code" : "JP.32.1853897",
                     "id" : 1853897,
                     "name" : "Osaka City"
                  },
                  "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.69374,
               "line" : null,
               "lng" : 135.50218,
               "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
            },
            "OrgRef" : {
               "all" : [
                  "604496"
               ],
               "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"
         ],
         "wikipedia_url" : "http://en.wikipedia.org/wiki/Osaka_City_University"
      },
      {
         "acronyms" : [
            "OPU"
         ],
         "addresses" : [
            {
               "city" : "Sakai",
               "country_geonames_id" : 1861060,
               "geonames_city" : {
                  "city" : "Sakai",
                  "geonames_admin1" : {
                     "ascii_name" : "Ōsaka",
                     "code" : "JP.32",
                     "id" : 1853904,
                     "name" : "Ōsaka"
                  },
                  "geonames_admin2" : {
                     "ascii_name" : "Sakai",
                     "code" : "JP.32.1853167",
                     "id" : 1853167,
                     "name" : "Sakai"
                  },
                  "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.58333,
               "line" : null,
               "lng" : 135.46667,
               "postcode" : null,
               "primary" : false,
               "state" : null,
               "state_code" : null
            }
         ],
         "aliases" : [
            "Ōsaka furitsu daigaku"
         ],
         "country" : {
            "country_code" : "JP",
            "country_name" : "Japan"
         },
         "email_address" : "",
         "established" : 1883,
         "external_ids" : {
            "GRID" : {
               "all" : "grid.261455.1",
               "preferred" : "grid.261455.1"
            },
            "ISNI" : {
               "all" : [
                  "0000 0001 0676 0594"
               ],
               "preferred" : null
            },
            "OrgRef" : {
               "all" : [
                  "2029014"
               ],
               "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" : 1861060,
               "geonames_city" : {
                  "city" : "Osaka",
                  "geonames_admin1" : {
                     "ascii_name" : "Ōsaka",
                     "code" : "JP.32",
                     "id" : 1853904,
                     "name" : "Ōsaka"
                  },
                  "geonames_admin2" : {
                     "ascii_name" : "Osaka City",
                     "code" : "JP.32.1853897",
                     "id" : 1853897,
                     "name" : "Osaka City"
                  },
                  "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.69374,
               "line" : null,
               "lng" : 135.50218,
               "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" : ""
      },
      {
         "acronyms" : [],
         "addresses" : [
            {
               "city" : "Osaka",
               "country_geonames_id" : 1861060,
               "geonames_city" : {
                  "city" : "Osaka",
                  "geonames_admin1" : {
                     "ascii_name" : "Ōsaka",
                     "code" : "JP.32",
                     "id" : 1853904,
                     "name" : "Ōsaka"
                  },
                  "geonames_admin2" : {
                     "ascii_name" : "Osaka City",
                     "code" : "JP.32.1853897",
                     "id" : 1853897,
                     "name" : "Osaka City"
                  },
                  "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.69374,
               "line" : null,
               "lng" : 135.50218,
               "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"
      }
   ],
   "meta" : {
      "countries" : [
         {
            "count" : 4,
            "id" : "jp",
            "title" : "Japan"
         }
      ],
      "statuses" : [
         {
            "count" : 4,
            "id" : "inactive",
            "title" : "inactive"
         }
      ],
      "types" : [
         {
            "count" : 4,
            "id" : "education",
            "title" : "Education"
         }
      ]
   },
   "number_of_results" : 4,
   "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"
            },
...