Query parameter

👍

ROR REST API v2

This page documents v2 of the ROR REST API. For v1 documentation of the ROR REST API, see https://ror.readme.io/v1/docs/api-query. You can also read more about ROR API versions and a summary of what's new in Schema 2.0.

About the query parameter

The query parameter is a "quick search" of only the names and external_ids fields in ROR. 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/v2/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/v2/organizations?query=Bath' | json_pp

As with retrieving a list of ROR records, the response is a JSON object containing full records for the first 20 search results, but this search produces only 16 results, so only 16 items are returned.

{
   "items" : [
      {
         "admin" : {
            "created" : {
               "date" : "2018-11-14",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2021-03-17",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : 2003,
         "external_ids" : [
            {
               "all" : [
                  "grid.432411.1"
               ],
               "preferred" : "grid.432411.1",
               "type" : "grid"
            }
         ],
         "id" : "https://ror.org/04hf68923",
         "links" : [
            {
               "type" : "website",
               "value" : "http://www.bathlabs.com/"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "GB",
                  "country_name" : "United Kingdom",
                  "lat" : 51.386501,
                  "lng" : -2.364442,
                  "name" : "Bath"
               },
               "geonames_id" : 2656173
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "Bath Labs"
            }
         ],
         "relationships" : [],
         "status" : "active",
         "types" : [
            "facility"
         ]
      },
      {
         "admin" : {
            "created" : {
               "date" : "2018-11-14",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2021-03-17",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : 1892,
         "external_ids" : [
            {
               "all" : [
                  "grid.468747.e"
               ],
               "preferred" : "grid.468747.e",
               "type" : "grid"
            },
            {
               "all" : [
                  "0000 0004 6437 268X"
               ],
               "preferred" : null,
               "type" : "isni"
            },
            {
               "all" : [
                  "Q5123579"
               ],
               "preferred" : null,
               "type" : "wikidata"
            }
         ],
         "id" : "https://ror.org/00pbyj886",
         "links" : [
            {
               "type" : "website",
               "value" : "https://www.bathcollege.ac.uk/"
            },
            {
               "type" : "wikipedia",
               "value" : "https://en.wikipedia.org/wiki/Bath_College"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "GB",
                  "country_name" : "United Kingdom",
                  "lat" : 51.380148,
                  "lng" : -2.362725,
                  "name" : "Bath"
               },
               "geonames_id" : 2656173
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "Bath College"
            }
         ],
         "relationships" : [],
         "status" : "active",
         "types" : [
            "education"
         ]
      },
      {
         "admin" : {
            "created" : {
               "date" : "2024-02-21",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2024-02-21",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : 1983,
         "external_ids" : [
            {
               "all" : [
                  "0000 0004 0578 2443"
               ],
               "preferred" : "0000 0004 0578 2443",
               "type" : "isni"
            }
         ],
         "id" : "https://ror.org/012mkjy35",
         "links" : [
            {
               "type" : "website",
               "value" : "https://www.circlehealthgroup.co.uk/hospitals/bath-clinic"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "GB",
                  "country_name" : "United Kingdom",
                  "lat" : 51.3751,
                  "lng" : -2.36172,
                  "name" : "Bath"
               },
               "geonames_id" : 2656173
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "alias"
               ],
               "value" : "BMI Bath Clinic"
            },
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "Bath Clinic"
            }
         ],
         "relationships" : [],
         "status" : "active",
         "types" : [
            "healthcare"
         ]
      },
      {
         "admin" : {
            "created" : {
               "date" : "2018-11-14",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2021-03-17",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : 2005,
         "external_ids" : [
            {
               "all" : [
                  "100010331"
               ],
               "preferred" : null,
               "type" : "fundref"
            },
            {
               "all" : [
                  "grid.252874.e"
               ],
               "preferred" : "grid.252874.e",
               "type" : "grid"
            },
            {
               "all" : [
                  "0000 0001 2034 9451"
               ],
               "preferred" : null,
               "type" : "isni"
            },
            {
               "all" : [
                  "Q3091754"
               ],
               "preferred" : null,
               "type" : "wikidata"
            }
         ],
         "id" : "https://ror.org/0038jbq24",
         "links" : [
            {
               "type" : "website",
               "value" : "https://www.bathspa.ac.uk/"
            },
            {
               "type" : "wikipedia",
               "value" : "http://en.wikipedia.org/wiki/Bath_Spa_University"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "GB",
                  "country_name" : "United Kingdom",
                  "lat" : 51.37598,
                  "lng" : -2.438833,
                  "name" : "Bath"
               },
               "geonames_id" : 2656173
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "alias"
               ],
               "value" : "Bath College of Higher Education"
            },
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "Bath Spa University"
            },
            {
               "lang" : null,
               "types" : [
                  "alias"
               ],
               "value" : "Bath Spa University College"
            }
         ],
         "relationships" : [],
         "status" : "active",
         "types" : [
            "education"
         ]
      },
      {
         "admin" : {
            "created" : {
               "date" : "2018-11-14",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2021-03-17",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : 1962,
         "external_ids" : [
            {
               "all" : [
                  "grid.447036.2"
               ],
               "preferred" : "grid.447036.2",
               "type" : "grid"
            },
            {
               "all" : [
                  "0000 0001 2226 6326"
               ],
               "preferred" : null,
               "type" : "isni"
            }
         ],
         "id" : "https://ror.org/0277k6k46",
         "links" : [
            {
               "type" : "website",
               "value" : "http://www.mainemaritimemuseum.org/"
            },
            {
               "type" : "wikipedia",
               "value" : "https://en.wikipedia.org/wiki/Maine_Maritime_Museum"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "US",
                  "country_name" : "United States",
                  "lat" : 43.893975,
                  "lng" : -69.815909,
                  "name" : "Bath"
               },
               "geonames_id" : 4957570
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "alias"
               ],
               "value" : "Bath Marine Museum"
            },
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "Maine Maritime Museum"
            }
         ],
         "relationships" : [],
         "status" : "active",
         "types" : [
            "archive"
         ]
      },
      {
         "admin" : {
            "created" : {
               "date" : "2018-11-14",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2021-03-17",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : 1969,
         "external_ids" : [
            {
               "all" : [
                  "grid.474071.1"
               ],
               "preferred" : "grid.474071.1",
               "type" : "grid"
            }
         ],
         "id" : "https://ror.org/03zhn2w96",
         "links" : [
            {
               "type" : "website",
               "value" : "http://www.maax.com/en"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "CA",
                  "country_name" : "Canada",
                  "lat" : 45.437374,
                  "lng" : -73.659299,
                  "name" : "Montréal"
               },
               "geonames_id" : 6077243
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "MAAX Bath (Canada)"
            }
         ],
         "relationships" : [],
         "status" : "active",
         "types" : [
            "company"
         ]
      },
      {
         "admin" : {
            "created" : {
               "date" : "2018-11-14",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2022-06-16",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : 1966,
         "external_ids" : [
            {
               "all" : [
                  "501100000835"
               ],
               "preferred" : null,
               "type" : "fundref"
            },
            {
               "all" : [
                  "grid.7340.0"
               ],
               "preferred" : "grid.7340.0",
               "type" : "grid"
            },
            {
               "all" : [
                  "0000 0001 2162 1699"
               ],
               "preferred" : null,
               "type" : "isni"
            },
            {
               "all" : [
                  "Q1422458"
               ],
               "preferred" : null,
               "type" : "wikidata"
            }
         ],
         "id" : "https://ror.org/002h8g185",
         "links" : [
            {
               "type" : "website",
               "value" : "http://www.bath.ac.uk/"
            },
            {
               "type" : "wikipedia",
               "value" : "http://en.wikipedia.org/wiki/University_of_Bath"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "GB",
                  "country_name" : "United Kingdom",
                  "lat" : 51.3751,
                  "lng" : -2.36172,
                  "name" : "Bath"
               },
               "geonames_id" : 2656173
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "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"
         ]
      },
      {
         "admin" : {
            "created" : {
               "date" : "2020-12-21",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2021-04-06",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : 1878,
         "external_ids" : [
            {
               "all" : [
                  "grid.509313.d"
               ],
               "preferred" : "grid.509313.d",
               "type" : "grid"
            },
            {
               "all" : [
                  "0000 0004 0420 1096"
               ],
               "preferred" : null,
               "type" : "isni"
            },
            {
               "all" : [
                  "Q4868960"
               ],
               "preferred" : null,
               "type" : "wikidata"
            }
         ],
         "id" : "https://ror.org/01d4n7s11",
         "links" : [
            {
               "type" : "website",
               "value" : "https://www.fingerlakes.va.gov/locations/Bath_VA_Medical_Center.asp"
            },
            {
               "type" : "wikipedia",
               "value" : "https://en.wikipedia.org/wiki/Bath_VA_Medical_Center"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "US",
                  "country_name" : "United States",
                  "lat" : 42.343611,
                  "lng" : -77.346111,
                  "name" : "Bath Beach"
               },
               "geonames_id" : 5108111
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "Bath VA Medical Center"
            }
         ],
         "relationships" : [
            {
               "id" : "https://ror.org/01rkxdk30",
               "label" : "VA Finger Lakes Healthcare System",
               "type" : "parent"
            }
         ],
         "status" : "active",
         "types" : [
            "healthcare"
         ]
      },
      {
         "admin" : {
            "created" : {
               "date" : "2018-11-14",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2021-03-17",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : 1975,
         "external_ids" : [
            {
               "all" : [
                  "grid.418231.d"
               ],
               "preferred" : "grid.418231.d",
               "type" : "grid"
            },
            {
               "all" : [
                  "0000 0004 0641 831X"
               ],
               "preferred" : null,
               "type" : "isni"
            },
            {
               "all" : [
                  "Q30281630"
               ],
               "preferred" : null,
               "type" : "wikidata"
            }
         ],
         "id" : "https://ror.org/05tacab76",
         "links" : [
            {
               "type" : "website",
               "value" : "http://www.birdbath.org.uk/"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "GB",
                  "country_name" : "United Kingdom",
                  "lat" : 51.382563,
                  "lng" : -2.36202,
                  "name" : "Bath"
               },
               "geonames_id" : 2656173
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "acronym"
               ],
               "value" : "BIRD"
            },
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "Bath Institute for Rheumatic Diseases"
            }
         ],
         "relationships" : [],
         "status" : "active",
         "types" : [
            "nonprofit"
         ]
      },
      {
         "admin" : {
            "created" : {
               "date" : "2018-11-14",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2021-03-17",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : 1968,
         "external_ids" : [
            {
               "all" : [
                  "grid.486748.1"
               ],
               "preferred" : "grid.486748.1",
               "type" : "grid"
            },
            {
               "all" : [
                  "0000 0004 0449 0078"
               ],
               "preferred" : null,
               "type" : "isni"
            }
         ],
         "id" : "https://ror.org/01datx010",
         "links" : [
            {
               "type" : "website",
               "value" : "http://www.designability.org.uk/"
            },
            {
               "type" : "wikipedia",
               "value" : "https://en.wikipedia.org/wiki/Bath_Institute_of_Medical_Engineering"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "GB",
                  "country_name" : "United Kingdom",
                  "lat" : 51.391294,
                  "lng" : -2.393219,
                  "name" : "Bath"
               },
               "geonames_id" : 2656173
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "alias"
               ],
               "value" : "Bath Institute of Medical Engineering"
            },
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "Designability"
            }
         ],
         "relationships" : [],
         "status" : "active",
         "types" : [
            "nonprofit"
         ]
      },
      {
         "admin" : {
            "created" : {
               "date" : "2018-11-14",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2021-03-17",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : 2011,
         "external_ids" : [
            {
               "all" : [
                  "grid.498158.9"
               ],
               "preferred" : "grid.498158.9",
               "type" : "grid"
            }
         ],
         "id" : "https://ror.org/0105p2r38",
         "links" : [
            {
               "type" : "website",
               "value" : "https://www.bbsp.co.uk/"
            },
            {
               "type" : "wikipedia",
               "value" : "https://en.wikipedia.org/wiki/Bristol_and_Bath_Science_Park"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "GB",
                  "country_name" : "United Kingdom",
                  "lat" : 51.501223,
                  "lng" : -2.478679,
                  "name" : "Bristol"
               },
               "geonames_id" : 2654675
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "acronym"
               ],
               "value" : "BBSP"
            },
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "Bristol and Bath Science Park"
            }
         ],
         "relationships" : [],
         "status" : "active",
         "types" : [
            "education"
         ]
      },
      {
         "admin" : {
            "created" : {
               "date" : "2018-11-14",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2021-03-17",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : 2016,
         "external_ids" : [
            {
               "all" : [
                  "grid.499705.6"
               ],
               "preferred" : "grid.499705.6",
               "type" : "grid"
            }
         ],
         "id" : "https://ror.org/02fzzq880",
         "links" : [
            {
               "type" : "website",
               "value" : "http://bathsdr.org/"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "GB",
                  "country_name" : "United Kingdom",
                  "lat" : 51.387285,
                  "lng" : -2.397273,
                  "name" : "Bath"
               },
               "geonames_id" : 2656173
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "acronym"
               ],
               "value" : "BSDR"
            },
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "Bath Social and Development Research"
            }
         ],
         "relationships" : [],
         "status" : "active",
         "types" : [
            "nonprofit"
         ]
      },
      {
         "admin" : {
            "created" : {
               "date" : "2018-11-14",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2022-11-15",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : 1824,
         "external_ids" : [
            {
               "all" : [
                  "grid.493239.6"
               ],
               "preferred" : "grid.493239.6",
               "type" : "grid"
            },
            {
               "all" : [
                  "0000 0004 5895 4392"
               ],
               "preferred" : "0000 0004 5895 4392",
               "type" : "isni"
            }
         ],
         "id" : "https://ror.org/046jgev73",
         "links" : [
            {
               "type" : "website",
               "value" : "https://www.brlsi.org/"
            },
            {
               "type" : "wikipedia",
               "value" : "https://en.wikipedia.org/wiki/Bath_Royal_Literary_and_Scientific_Institution"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "GB",
                  "country_name" : "United Kingdom",
                  "lat" : 51.3751,
                  "lng" : -2.36172,
                  "name" : "Bath"
               },
               "geonames_id" : 2656173
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "acronym"
               ],
               "value" : "BRLSI"
            },
            {
               "lang" : null,
               "types" : [
                  "alias"
               ],
               "value" : "Bath Literary and Scientific Institution"
            },
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "Bath Royal Literary and Scientific Institution"
            }
         ],
         "relationships" : [],
         "status" : "active",
         "types" : [
            "other"
         ]
      },
      {
         "admin" : {
            "created" : {
               "date" : "2018-11-14",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2021-09-23",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : 1996,
         "external_ids" : [
            {
               "all" : [
                  "grid.450510.5"
               ],
               "preferred" : "grid.450510.5",
               "type" : "grid"
            },
            {
               "all" : [
                  "0000 0004 0374 2966"
               ],
               "preferred" : null,
               "type" : "isni"
            },
            {
               "all" : [
                  "Q16966588"
               ],
               "preferred" : null,
               "type" : "wikidata"
            }
         ],
         "id" : "https://ror.org/03rwxcx12",
         "links" : [
            {
               "type" : "website",
               "value" : "http://www.bathnes.gov.uk/"
            },
            {
               "type" : "wikipedia",
               "value" : "https://en.wikipedia.org/wiki/Bath_and_North_East_Somerset_Council"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "GB",
                  "country_name" : "United Kingdom",
                  "lat" : 51.415436,
                  "lng" : -2.491173,
                  "name" : "Bath"
               },
               "geonames_id" : 2656173
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "Bath and North East Somerset Council"
            }
         ],
         "relationships" : [],
         "status" : "active",
         "types" : [
            "government"
         ]
      },
      {
         "admin" : {
            "created" : {
               "date" : "2018-11-14",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2021-03-17",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : 1864,
         "external_ids" : [
            {
               "all" : [
                  "grid.413029.d"
               ],
               "preferred" : "grid.413029.d",
               "type" : "grid"
            },
            {
               "all" : [
                  "0000 0004 0374 2907"
               ],
               "preferred" : null,
               "type" : "isni"
            },
            {
               "all" : [
                  "Q18162105"
               ],
               "preferred" : null,
               "type" : "wikidata"
            }
         ],
         "id" : "https://ror.org/058x7dy48",
         "links" : [
            {
               "type" : "website",
               "value" : "http://www.ruh.nhs.uk/"
            },
            {
               "type" : "wikipedia",
               "value" : "https://en.wikipedia.org/wiki/Royal_United_Hospital_Bath_NHS_Foundation_Trust"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "GB",
                  "country_name" : "United Kingdom",
                  "lat" : 51.391932,
                  "lng" : -2.389183,
                  "name" : "Bath"
               },
               "geonames_id" : 2656173
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "alias"
               ],
               "value" : "Royal United Hospital Bath NHS Foundation Trust"
            },
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "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"
         ]
      },
      {
         "admin" : {
            "created" : {
               "date" : "2018-11-14",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2021-03-17",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : null,
         "external_ids" : [
            {
               "all" : [
                  "grid.476920.e"
               ],
               "preferred" : "grid.476920.e",
               "type" : "grid"
            }
         ],
         "id" : "https://ror.org/00pkb6h65",
         "links" : [
            {
               "type" : "website",
               "value" : "http://www.bathandnortheastsomersetccg.nhs.uk/"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "GB",
                  "country_name" : "United Kingdom",
                  "lat" : 51.35779,
                  "lng" : -2.372919,
                  "name" : "Bath"
               },
               "geonames_id" : 2656173
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "acronym"
               ],
               "value" : "BaNES CCG"
            },
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "Bath and North East Somerset Clinical Commissioning Group"
            }
         ],
         "relationships" : [],
         "status" : "active",
         "types" : [
            "healthcare"
         ]
      }
   ],
   "meta" : {
      "countries" : [
         {
            "count" : 13,
            "id" : "gb",
            "title" : "United Kingdom"
         },
         {
            "count" : 2,
            "id" : "us",
            "title" : "United States"
         },
         {
            "count" : 1,
            "id" : "ca",
            "title" : "Canada"
         }
      ],
      "statuses" : [
         {
            "count" : 16,
            "id" : "active",
            "title" : "active"
         }
      ],
      "types" : [
         {
            "count" : 4,
            "id" : "education",
            "title" : "education"
         },
         {
            "count" : 4,
            "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" : 16,
   "time_taken" : 41
}

🚧

Remember that the query parameter does not search all fields

The query parameter searches only the names field, which includes acronyms, aliases, and the organization names in various languages, and the external_ids field. Results from keyword searches using the query parameter do not include values from fields such as links and locations, for instance. To find organizations by website, location, or other criteria, 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/v2/organizations?query=Bath%20College' | json_pp

This search looks for both the term "Bath" and the term "College" and returns over 4600 results because the term "College" appears in many organization names. A search on the single term "Bath" produces only 16 results, because it is a much less common term in organization names. The organization record for Bath College is the first of over 4600 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" : [
      {
         "admin" : {
            "created" : {
               "date" : "2018-11-14",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2021-03-17",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : 1892,
         "external_ids" : [
            {
               "all" : [
                  "grid.468747.e"
               ],
               "preferred" : "grid.468747.e",
               "type" : "grid"
            },
            {
               "all" : [
                  "0000 0004 6437 268X"
               ],
               "preferred" : null,
               "type" : "isni"
            },
            {
               "all" : [
                  "Q5123579"
               ],
               "preferred" : null,
               "type" : "wikidata"
            }
         ],
         "id" : "https://ror.org/00pbyj886",
         "links" : [
            {
               "type" : "website",
               "value" : "https://www.bathcollege.ac.uk/"
            },
            {
               "type" : "wikipedia",
               "value" : "https://en.wikipedia.org/wiki/Bath_College"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "GB",
                  "country_name" : "United Kingdom",
                  "lat" : 51.380148,
                  "lng" : -2.362725,
                  "name" : "Bath"
               },
               "geonames_id" : 2656173
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "Bath College"
            }
         ],
         "relationships" : [],
         "status" : "active",
         "types" : [
            "education"
         ]
      },
      {
         "admin" : {
            "created" : {
               "date" : "2018-11-14",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2021-03-17",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : 2005,
         "external_ids" : [
            {
               "all" : [
                  "100010331"
               ],
               "preferred" : null,
               "type" : "fundref"
            },
            {
               "all" : [
                  "grid.252874.e"
               ],
               "preferred" : "grid.252874.e",
               "type" : "grid"
            },
            {
               "all" : [
                  "0000 0001 2034 9451"
               ],
               "preferred" : null,
               "type" : "isni"
            },
            {
               "all" : [
                  "Q3091754"
               ],
               "preferred" : null,
               "type" : "wikidata"
            }
         ],
         "id" : "https://ror.org/0038jbq24",
         "links" : [
            {
               "type" : "website",
               "value" : "https://www.bathspa.ac.uk/"
            },
            {
               "type" : "wikipedia",
               "value" : "http://en.wikipedia.org/wiki/Bath_Spa_University"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "GB",
                  "country_name" : "United Kingdom",
                  "lat" : 51.37598,
                  "lng" : -2.438833,
                  "name" : "Bath"
               },
               "geonames_id" : 2656173
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "alias"
               ],
               "value" : "Bath College of Higher Education"
            },
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "Bath Spa University"
            },
            {
               "lang" : null,
               "types" : [
                  "alias"
               ],
               "value" : "Bath Spa University College"
            }
         ],
         "relationships" : [],
         "status" : "active",
         "types" : [
            "education"
         ]
      },
      {
         "admin" : {
            "created" : {
               "date" : "2018-11-14",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2021-03-17",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : 2003,
         "external_ids" : [
            {
               "all" : [
                  "grid.432411.1"
               ],
               "preferred" : "grid.432411.1",
               "type" : "grid"
            }
         ],
         "id" : "https://ror.org/04hf68923",
         "links" : [
            {
               "type" : "website",
               "value" : "http://www.bathlabs.com/"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "GB",
                  "country_name" : "United Kingdom",
                  "lat" : 51.386501,
                  "lng" : -2.364442,
                  "name" : "Bath"
               },
               "geonames_id" : 2656173
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "Bath Labs"
            }
         ],
         "relationships" : [],
         "status" : "active",
         "types" : [
            "facility"
         ]
      },
      {
         "admin" : {
            "created" : {
               "date" : "2024-02-21",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2024-02-21",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : 1983,
         "external_ids" : [
            {
               "all" : [
                  "0000 0004 0578 2443"
               ],
               "preferred" : "0000 0004 0578 2443",
               "type" : "isni"
            }
         ],
         "id" : "https://ror.org/012mkjy35",
         "links" : [
            {
               "type" : "website",
               "value" : "https://www.circlehealthgroup.co.uk/hospitals/bath-clinic"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "GB",
                  "country_name" : "United Kingdom",
                  "lat" : 51.3751,
                  "lng" : -2.36172,
                  "name" : "Bath"
               },
               "geonames_id" : 2656173
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "alias"
               ],
               "value" : "BMI Bath Clinic"
            },
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "Bath Clinic"
            }
         ],
         "relationships" : [],
         "status" : "active",
         "types" : [
            "healthcare"
         ]
      },
      {
         "admin" : {
            "created" : {
               "date" : "2018-11-14",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2021-03-17",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : 1962,
         "external_ids" : [
            {
               "all" : [
                  "grid.447036.2"
               ],
               "preferred" : "grid.447036.2",
               "type" : "grid"
            },
            {
               "all" : [
                  "0000 0001 2226 6326"
               ],
               "preferred" : null,
               "type" : "isni"
            }
         ],
         "id" : "https://ror.org/0277k6k46",
         "links" : [
            {
               "type" : "website",
               "value" : "http://www.mainemaritimemuseum.org/"
            },
            {
               "type" : "wikipedia",
               "value" : "https://en.wikipedia.org/wiki/Maine_Maritime_Museum"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "US",
                  "country_name" : "United States",
                  "lat" : 43.893975,
                  "lng" : -69.815909,
                  "name" : "Bath"
               },
               "geonames_id" : 4957570
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "alias"
               ],
               "value" : "Bath Marine Museum"
            },
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "Maine Maritime Museum"
            }
         ],
         "relationships" : [],
         "status" : "active",
         "types" : [
            "archive"
         ]
      },
      {
         "admin" : {
            "created" : {
               "date" : "2018-11-14",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2021-03-17",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : 1969,
         "external_ids" : [
            {
               "all" : [
                  "grid.474071.1"
               ],
               "preferred" : "grid.474071.1",
               "type" : "grid"
            }
         ],
         "id" : "https://ror.org/03zhn2w96",
         "links" : [
            {
               "type" : "website",
               "value" : "http://www.maax.com/en"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "CA",
                  "country_name" : "Canada",
                  "lat" : 45.437374,
                  "lng" : -73.659299,
                  "name" : "Montréal"
               },
               "geonames_id" : 6077243
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "MAAX Bath (Canada)"
            }
         ],
         "relationships" : [],
         "status" : "active",
         "types" : [
            "company"
         ]
      },
      {
         "admin" : {
            "created" : {
               "date" : "2018-11-14",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2022-06-16",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : 1966,
         "external_ids" : [
            {
               "all" : [
                  "501100000835"
               ],
               "preferred" : null,
               "type" : "fundref"
            },
            {
               "all" : [
                  "grid.7340.0"
               ],
               "preferred" : "grid.7340.0",
               "type" : "grid"
            },
            {
               "all" : [
                  "0000 0001 2162 1699"
               ],
               "preferred" : null,
               "type" : "isni"
            },
            {
               "all" : [
                  "Q1422458"
               ],
               "preferred" : null,
               "type" : "wikidata"
            }
         ],
         "id" : "https://ror.org/002h8g185",
         "links" : [
            {
               "type" : "website",
               "value" : "http://www.bath.ac.uk/"
            },
            {
               "type" : "wikipedia",
               "value" : "http://en.wikipedia.org/wiki/University_of_Bath"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "GB",
                  "country_name" : "United Kingdom",
                  "lat" : 51.3751,
                  "lng" : -2.36172,
                  "name" : "Bath"
               },
               "geonames_id" : 2656173
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "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"
         ]
      },
      {
         "admin" : {
            "created" : {
               "date" : "2020-12-21",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2021-04-06",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : 1878,
         "external_ids" : [
            {
               "all" : [
                  "grid.509313.d"
               ],
               "preferred" : "grid.509313.d",
               "type" : "grid"
            },
            {
               "all" : [
                  "0000 0004 0420 1096"
               ],
               "preferred" : null,
               "type" : "isni"
            },
            {
               "all" : [
                  "Q4868960"
               ],
               "preferred" : null,
               "type" : "wikidata"
            }
         ],
         "id" : "https://ror.org/01d4n7s11",
         "links" : [
            {
               "type" : "website",
               "value" : "https://www.fingerlakes.va.gov/locations/Bath_VA_Medical_Center.asp"
            },
            {
               "type" : "wikipedia",
               "value" : "https://en.wikipedia.org/wiki/Bath_VA_Medical_Center"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "US",
                  "country_name" : "United States",
                  "lat" : 42.343611,
                  "lng" : -77.346111,
                  "name" : "Bath Beach"
               },
               "geonames_id" : 5108111
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "Bath VA Medical Center"
            }
         ],
         "relationships" : [
            {
               "id" : "https://ror.org/01rkxdk30",
               "label" : "VA Finger Lakes Healthcare System",
               "type" : "parent"
            }
         ],
         "status" : "active",
         "types" : [
            "healthcare"
         ]
      },
      {
         "admin" : {
            "created" : {
               "date" : "2018-11-14",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2021-03-17",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : 1975,
         "external_ids" : [
            {
               "all" : [
                  "grid.418231.d"
               ],
               "preferred" : "grid.418231.d",
               "type" : "grid"
            },
            {
               "all" : [
                  "0000 0004 0641 831X"
               ],
               "preferred" : null,
               "type" : "isni"
            },
            {
               "all" : [
                  "Q30281630"
               ],
               "preferred" : null,
               "type" : "wikidata"
            }
         ],
         "id" : "https://ror.org/05tacab76",
         "links" : [
            {
               "type" : "website",
               "value" : "http://www.birdbath.org.uk/"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "GB",
                  "country_name" : "United Kingdom",
                  "lat" : 51.382563,
                  "lng" : -2.36202,
                  "name" : "Bath"
               },
               "geonames_id" : 2656173
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "acronym"
               ],
               "value" : "BIRD"
            },
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "Bath Institute for Rheumatic Diseases"
            }
         ],
         "relationships" : [],
         "status" : "active",
         "types" : [
            "nonprofit"
         ]
      },
      {
         "admin" : {
            "created" : {
               "date" : "2018-11-14",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2021-03-17",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : 1968,
         "external_ids" : [
            {
               "all" : [
                  "grid.486748.1"
               ],
               "preferred" : "grid.486748.1",
               "type" : "grid"
            },
            {
               "all" : [
                  "0000 0004 0449 0078"
               ],
               "preferred" : null,
               "type" : "isni"
            }
         ],
         "id" : "https://ror.org/01datx010",
         "links" : [
            {
               "type" : "website",
               "value" : "http://www.designability.org.uk/"
            },
            {
               "type" : "wikipedia",
               "value" : "https://en.wikipedia.org/wiki/Bath_Institute_of_Medical_Engineering"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "GB",
                  "country_name" : "United Kingdom",
                  "lat" : 51.391294,
                  "lng" : -2.393219,
                  "name" : "Bath"
               },
               "geonames_id" : 2656173
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "alias"
               ],
               "value" : "Bath Institute of Medical Engineering"
            },
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "Designability"
            }
         ],
         "relationships" : [],
         "status" : "active",
         "types" : [
            "nonprofit"
         ]
      },
      {
         "admin" : {
            "created" : {
               "date" : "2018-11-14",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2021-03-17",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : 2011,
         "external_ids" : [
            {
               "all" : [
                  "grid.498158.9"
               ],
               "preferred" : "grid.498158.9",
               "type" : "grid"
            }
         ],
         "id" : "https://ror.org/0105p2r38",
         "links" : [
            {
               "type" : "website",
               "value" : "https://www.bbsp.co.uk/"
            },
            {
               "type" : "wikipedia",
               "value" : "https://en.wikipedia.org/wiki/Bristol_and_Bath_Science_Park"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "GB",
                  "country_name" : "United Kingdom",
                  "lat" : 51.501223,
                  "lng" : -2.478679,
                  "name" : "Bristol"
               },
               "geonames_id" : 2654675
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "acronym"
               ],
               "value" : "BBSP"
            },
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "Bristol and Bath Science Park"
            }
         ],
         "relationships" : [],
         "status" : "active",
         "types" : [
            "education"
         ]
      },
      {
         "admin" : {
            "created" : {
               "date" : "2018-11-14",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2021-03-17",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : 2016,
         "external_ids" : [
            {
               "all" : [
                  "grid.499705.6"
               ],
               "preferred" : "grid.499705.6",
               "type" : "grid"
            }
         ],
         "id" : "https://ror.org/02fzzq880",
         "links" : [
            {
               "type" : "website",
               "value" : "http://bathsdr.org/"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "GB",
                  "country_name" : "United Kingdom",
                  "lat" : 51.387285,
                  "lng" : -2.397273,
                  "name" : "Bath"
               },
               "geonames_id" : 2656173
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "acronym"
               ],
               "value" : "BSDR"
            },
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "Bath Social and Development Research"
            }
         ],
         "relationships" : [],
         "status" : "active",
         "types" : [
            "nonprofit"
         ]
      },
      {
         "admin" : {
            "created" : {
               "date" : "2018-11-14",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2022-11-15",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : 1824,
         "external_ids" : [
            {
               "all" : [
                  "grid.493239.6"
               ],
               "preferred" : "grid.493239.6",
               "type" : "grid"
            },
            {
               "all" : [
                  "0000 0004 5895 4392"
               ],
               "preferred" : "0000 0004 5895 4392",
               "type" : "isni"
            }
         ],
         "id" : "https://ror.org/046jgev73",
         "links" : [
            {
               "type" : "website",
               "value" : "https://www.brlsi.org/"
            },
            {
               "type" : "wikipedia",
               "value" : "https://en.wikipedia.org/wiki/Bath_Royal_Literary_and_Scientific_Institution"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "GB",
                  "country_name" : "United Kingdom",
                  "lat" : 51.3751,
                  "lng" : -2.36172,
                  "name" : "Bath"
               },
               "geonames_id" : 2656173
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "acronym"
               ],
               "value" : "BRLSI"
            },
            {
               "lang" : null,
               "types" : [
                  "alias"
               ],
               "value" : "Bath Literary and Scientific Institution"
            },
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "Bath Royal Literary and Scientific Institution"
            }
         ],
         "relationships" : [],
         "status" : "active",
         "types" : [
            "other"
         ]
      },
      {
         "admin" : {
            "created" : {
               "date" : "2018-11-14",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2021-09-23",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : 1996,
         "external_ids" : [
            {
               "all" : [
                  "grid.450510.5"
               ],
               "preferred" : "grid.450510.5",
               "type" : "grid"
            },
            {
               "all" : [
                  "0000 0004 0374 2966"
               ],
               "preferred" : null,
               "type" : "isni"
            },
            {
               "all" : [
                  "Q16966588"
               ],
               "preferred" : null,
               "type" : "wikidata"
            }
         ],
         "id" : "https://ror.org/03rwxcx12",
         "links" : [
            {
               "type" : "website",
               "value" : "http://www.bathnes.gov.uk/"
            },
            {
               "type" : "wikipedia",
               "value" : "https://en.wikipedia.org/wiki/Bath_and_North_East_Somerset_Council"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "GB",
                  "country_name" : "United Kingdom",
                  "lat" : 51.415436,
                  "lng" : -2.491173,
                  "name" : "Bath"
               },
               "geonames_id" : 2656173
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "Bath and North East Somerset Council"
            }
         ],
         "relationships" : [],
         "status" : "active",
         "types" : [
            "government"
         ]
      },
      {
         "admin" : {
            "created" : {
               "date" : "2018-11-14",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2021-03-17",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : 1864,
         "external_ids" : [
            {
               "all" : [
                  "grid.413029.d"
               ],
               "preferred" : "grid.413029.d",
               "type" : "grid"
            },
            {
               "all" : [
                  "0000 0004 0374 2907"
               ],
               "preferred" : null,
               "type" : "isni"
            },
            {
               "all" : [
                  "Q18162105"
               ],
               "preferred" : null,
               "type" : "wikidata"
            }
         ],
         "id" : "https://ror.org/058x7dy48",
         "links" : [
            {
               "type" : "website",
               "value" : "http://www.ruh.nhs.uk/"
            },
            {
               "type" : "wikipedia",
               "value" : "https://en.wikipedia.org/wiki/Royal_United_Hospital_Bath_NHS_Foundation_Trust"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "GB",
                  "country_name" : "United Kingdom",
                  "lat" : 51.391932,
                  "lng" : -2.389183,
                  "name" : "Bath"
               },
               "geonames_id" : 2656173
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "alias"
               ],
               "value" : "Royal United Hospital Bath NHS Foundation Trust"
            },
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "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"
         ]
      },
      {
         "admin" : {
            "created" : {
               "date" : "2018-11-14",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2021-03-17",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : null,
         "external_ids" : [
            {
               "all" : [
                  "grid.476920.e"
               ],
               "preferred" : "grid.476920.e",
               "type" : "grid"
            }
         ],
         "id" : "https://ror.org/00pkb6h65",
         "links" : [
            {
               "type" : "website",
               "value" : "http://www.bathandnortheastsomersetccg.nhs.uk/"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "GB",
                  "country_name" : "United Kingdom",
                  "lat" : 51.35779,
                  "lng" : -2.372919,
                  "name" : "Bath"
               },
               "geonames_id" : 2656173
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "acronym"
               ],
               "value" : "BaNES CCG"
            },
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "Bath and North East Somerset Clinical Commissioning Group"
            }
         ],
         "relationships" : [],
         "status" : "active",
         "types" : [
            "healthcare"
         ]
      },
      {
         "admin" : {
            "created" : {
               "date" : "2018-11-14",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2021-03-17",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : 1965,
         "external_ids" : [
            {
               "all" : [
                  "grid.443664.7"
               ],
               "preferred" : "grid.443664.7",
               "type" : "grid"
            },
            {
               "all" : [
                  "0000 0004 0642 2167"
               ],
               "preferred" : null,
               "type" : "isni"
            },
            {
               "all" : [
                  "Q11526509"
               ],
               "preferred" : null,
               "type" : "wikidata"
            }
         ],
         "id" : "https://ror.org/01n7wbg90",
         "links" : [
            {
               "type" : "website",
               "value" : "http://www.higashiosaka.ac.jp/"
            },
            {
               "type" : "wikipedia",
               "value" : "https://en.wikipedia.org/wiki/Higashiosaka_Junior_College"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "JP",
                  "country_name" : "Japan",
                  "lat" : 34.6758,
                  "lng" : 135.581458,
                  "name" : "Higashi-ōsaka"
               },
               "geonames_id" : 1862752
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "Higashiosaka College & Higashiosaka Junior College"
            },
            {
               "lang" : null,
               "types" : [
                  "alias"
               ],
               "value" : "Higashiosaka Junior College"
            },
            {
               "lang" : "ja",
               "types" : [
                  "label"
               ],
               "value" : "東大阪大学・東大阪大学短期大学部"
            }
         ],
         "relationships" : [],
         "status" : "active",
         "types" : [
            "education"
         ]
      },
      {
         "admin" : {
            "created" : {
               "date" : "2018-11-14",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2021-03-17",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : 1873,
         "external_ids" : [
            {
               "all" : [
                  "100008414"
               ],
               "preferred" : null,
               "type" : "fundref"
            },
            {
               "all" : [
                  "grid.21006.35"
               ],
               "preferred" : "grid.21006.35",
               "type" : "grid"
            },
            {
               "all" : [
                  "0000 0001 2179 4063"
               ],
               "preferred" : null,
               "type" : "isni"
            },
            {
               "all" : [
                  "Q432475"
               ],
               "preferred" : null,
               "type" : "wikidata"
            }
         ],
         "id" : "https://ror.org/03y7q9t39",
         "links" : [
            {
               "type" : "website",
               "value" : "http://www.canterbury.ac.nz/"
            },
            {
               "type" : "wikipedia",
               "value" : "http://en.wikipedia.org/wiki/University_of_Canterbury"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "NZ",
                  "country_name" : "New Zealand",
                  "lat" : -43.523333,
                  "lng" : 172.581944,
                  "name" : "Christchurch"
               },
               "geonames_id" : 2192362
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "alias"
               ],
               "value" : "Canterbury College"
            },
            {
               "lang" : "mi",
               "types" : [
                  "label"
               ],
               "value" : "Te Whare Wānanga o Waitaha"
            },
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "University of Canterbury"
            }
         ],
         "relationships" : [
            {
               "id" : "https://ror.org/05p61mv27",
               "label" : "The Dodd-Walls Centre for Photonic and Quantum Technologies",
               "type" : "child"
            }
         ],
         "status" : "active",
         "types" : [
            "education"
         ]
      },
      {
         "admin" : {
            "created" : {
               "date" : "2018-11-14",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2021-03-17",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : 1899,
         "external_ids" : [
            {
               "all" : [
                  "100006612"
               ],
               "preferred" : null,
               "type" : "fundref"
            },
            {
               "all" : [
                  "grid.28203.3b"
               ],
               "preferred" : "grid.28203.3b",
               "type" : "grid"
            },
            {
               "all" : [
                  "0000 0004 0378 6053"
               ],
               "preferred" : null,
               "type" : "isni"
            },
            {
               "all" : [
                  "Q14437811"
               ],
               "preferred" : null,
               "type" : "wikidata"
            }
         ],
         "id" : "https://ror.org/04mbfgm16",
         "links" : [
            {
               "type" : "website",
               "value" : "http://www.simmons.edu/"
            },
            {
               "type" : "wikipedia",
               "value" : "https://en.wikipedia.org/wiki/Simmons_College"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "US",
                  "country_name" : "United States",
                  "lat" : 42.339717,
                  "lng" : -71.100745,
                  "name" : "Boston"
               },
               "geonames_id" : 4930956
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "alias"
               ],
               "value" : "Simmons College"
            },
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "Simmons University"
            }
         ],
         "relationships" : [],
         "status" : "active",
         "types" : [
            "education"
         ]
      },
      {
         "admin" : {
            "created" : {
               "date" : "2018-11-14",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2021-03-17",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : 1911,
         "external_ids" : [
            {
               "all" : [
                  "100008580",
                  "100008581"
               ],
               "preferred" : "100008580",
               "type" : "fundref"
            },
            {
               "all" : [
                  "grid.57926.3f"
               ],
               "preferred" : "grid.57926.3f",
               "type" : "grid"
            },
            {
               "all" : [
                  "0000 0004 1936 9131"
               ],
               "preferred" : null,
               "type" : "isni"
            },
            {
               "all" : [
                  "Q3104287"
               ],
               "preferred" : null,
               "type" : "wikidata"
            }
         ],
         "id" : "https://ror.org/03dzc0485",
         "links" : [
            {
               "type" : "website",
               "value" : "http://www.uregina.ca/"
            },
            {
               "type" : "wikipedia",
               "value" : "http://en.wikipedia.org/wiki/University_of_Regina"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "CA",
                  "country_name" : "Canada",
                  "lat" : 50.415553,
                  "lng" : -104.587953,
                  "name" : "Regina"
               },
               "geonames_id" : 6119109
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "alias"
               ],
               "value" : "Regina Campus of the University of Saskatchewan"
            },
            {
               "lang" : null,
               "types" : [
                  "alias"
               ],
               "value" : "Regina College"
            },
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "University of Regina"
            },
            {
               "lang" : "fr",
               "types" : [
                  "label"
               ],
               "value" : "Université de regina"
            }
         ],
         "relationships" : [
            {
               "id" : "https://ror.org/03pkwvf72",
               "label" : "Campion College",
               "type" : "related"
            }
         ],
         "status" : "active",
         "types" : [
            "education"
         ]
      }
   ],
   "meta" : {
      "countries" : [
         {
            "count" : 2097,
            "id" : "us",
            "title" : "United States"
         },
         {
            "count" : 390,
            "id" : "in",
            "title" : "India"
         },
         {
            "count" : 360,
            "id" : "jp",
            "title" : "Japan"
         },
         {
            "count" : 336,
            "id" : "gb",
            "title" : "United Kingdom"
         },
         {
            "count" : 271,
            "id" : "cn",
            "title" : "China"
         },
         {
            "count" : 162,
            "id" : "ca",
            "title" : "Canada"
         },
         {
            "count" : 110,
            "id" : "ph",
            "title" : "Philippines"
         },
         {
            "count" : 61,
            "id" : "kr",
            "title" : "South Korea"
         },
         {
            "count" : 53,
            "id" : "au",
            "title" : "Australia"
         },
         {
            "count" : 48,
            "id" : "pk",
            "title" : "Pakistan"
         }
      ],
      "statuses" : [
         {
            "count" : 4674,
            "id" : "active",
            "title" : "active"
         }
      ],
      "types" : [
         {
            "count" : 4357,
            "id" : "education",
            "title" : "education"
         },
         {
            "count" : 181,
            "id" : "healthcare",
            "title" : "healthcare"
         },
         {
            "count" : 63,
            "id" : "nonprofit",
            "title" : "nonprofit"
         },
         {
            "count" : 46,
            "id" : "other",
            "title" : "other"
         },
         {
            "count" : 17,
            "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" : 4674,
   "time_taken" : 11
}

🚧

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 the names field. Remember that the names field can include names in several languages, acronyms, and aliases.

curl 'https://api.ror.org/v2/organizations?query=%22Bath%20College%22' | json_pp

The response returns 2 records: the record for Bath College and the record for Bath Spa University, which has the alias "Bath College of Higher Education".

{
   "items" : [
      {
         "admin" : {
            "created" : {
               "date" : "2018-11-14",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2021-03-17",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : 1892,
         "external_ids" : [
            {
               "all" : [
                  "grid.468747.e"
               ],
               "preferred" : "grid.468747.e",
               "type" : "grid"
            },
            {
               "all" : [
                  "0000 0004 6437 268X"
               ],
               "preferred" : null,
               "type" : "isni"
            },
            {
               "all" : [
                  "Q5123579"
               ],
               "preferred" : null,
               "type" : "wikidata"
            }
         ],
         "id" : "https://ror.org/00pbyj886",
         "links" : [
            {
               "type" : "website",
               "value" : "https://www.bathcollege.ac.uk/"
            },
            {
               "type" : "wikipedia",
               "value" : "https://en.wikipedia.org/wiki/Bath_College"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "GB",
                  "country_name" : "United Kingdom",
                  "lat" : 51.380148,
                  "lng" : -2.362725,
                  "name" : "Bath"
               },
               "geonames_id" : 2656173
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "Bath College"
            }
         ],
         "relationships" : [],
         "status" : "active",
         "types" : [
            "education"
         ]
      },
      {
         "admin" : {
            "created" : {
               "date" : "2018-11-14",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2021-03-17",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : 2005,
         "external_ids" : [
            {
               "all" : [
                  "100010331"
               ],
               "preferred" : null,
               "type" : "fundref"
            },
            {
               "all" : [
                  "grid.252874.e"
               ],
               "preferred" : "grid.252874.e",
               "type" : "grid"
            },
            {
               "all" : [
                  "0000 0001 2034 9451"
               ],
               "preferred" : null,
               "type" : "isni"
            },
            {
               "all" : [
                  "Q3091754"
               ],
               "preferred" : null,
               "type" : "wikidata"
            }
         ],
         "id" : "https://ror.org/0038jbq24",
         "links" : [
            {
               "type" : "website",
               "value" : "https://www.bathspa.ac.uk/"
            },
            {
               "type" : "wikipedia",
               "value" : "http://en.wikipedia.org/wiki/Bath_Spa_University"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "GB",
                  "country_name" : "United Kingdom",
                  "lat" : 51.37598,
                  "lng" : -2.438833,
                  "name" : "Bath"
               },
               "geonames_id" : 2656173
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "alias"
               ],
               "value" : "Bath College of Higher Education"
            },
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "Bath Spa University"
            },
            {
               "lang" : null,
               "types" : [
                  "alias"
               ],
               "value" : "Bath Spa University College"
            }
         ],
         "relationships" : [],
         "status" : "active",
         "types" : [
            "education"
         ]
      }
   ],
   "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" : 123
}

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

When the & is URL-encoded, the response returns the single record for Franklin & Marshall College. When the & is not URL-encoded, the response is an error.

{
   "items" : [
      {
         "admin" : {
            "created" : {
               "date" : "2018-11-14",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2022-11-15",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : 1787,
         "external_ids" : [
            {
               "all" : [
                  "100012632"
               ],
               "preferred" : "100012632",
               "type" : "fundref"
            },
            {
               "all" : [
                  "grid.256069.e"
               ],
               "preferred" : "grid.256069.e",
               "type" : "grid"
            },
            {
               "all" : [
                  "0000 0001 2162 8305"
               ],
               "preferred" : "0000 0001 2162 8305",
               "type" : "isni"
            },
            {
               "all" : [
                  "Q664881"
               ],
               "preferred" : null,
               "type" : "wikidata"
            }
         ],
         "id" : "https://ror.org/04fp4ps48",
         "links" : [
            {
               "type" : "website",
               "value" : "http://www.fandm.edu/"
            },
            {
               "type" : "wikipedia",
               "value" : "https://en.wikipedia.org/wiki/Franklin_%26_Marshall_College"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "US",
                  "country_name" : "United States",
                  "lat" : 40.03788,
                  "lng" : -76.30551,
                  "name" : "Lancaster"
               },
               "geonames_id" : 5197079
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "acronym"
               ],
               "value" : "F&M"
            },
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "Franklin & Marshall College"
            }
         ],
         "relationships" : [],
         "status" : "active",
         "types" : [
            "education"
         ]
      }
   ],
   "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" : 21
}

Searching for identifiers

The query parameter searches the external_ids field and so can be used to search for ROR records that match an external unique identifier. Use URL-encoded quotation marks before and after the identifier search string for best results. This search will work for all identifier schemes supported in the external_ids field, including GRID, ISNI, Wikidata, and the Crossref Open Funder Registry.

Example

Search for a ROR record corresponding to the GRID ID for the U.S. Department of Energy.

curl 'https://api.ror.org/v2/organizations?query=%22grid.85084.31%22' | json_pp

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

{
   "items" : [
      {
         "admin" : {
            "created" : {
               "date" : "2018-11-14",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2024-03-28",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : 1977,
         "external_ids" : [
            {
               "all" : [
                  "100000015"
               ],
               "preferred" : "100000015",
               "type" : "fundref"
            },
            {
               "all" : [
                  "grid.85084.31"
               ],
               "preferred" : "grid.85084.31",
               "type" : "grid"
            },
            {
               "all" : [
                  "0000 0001 2342 3717"
               ],
               "preferred" : null,
               "type" : "isni"
            },
            {
               "all" : [
                  "Q217810",
                  "Q6422983"
               ],
               "preferred" : "Q217810",
               "type" : "wikidata"
            }
         ],
         "id" : "https://ror.org/01bj3aw27",
         "links" : [
            {
               "type" : "website",
               "value" : "https://www.energy.gov"
            },
            {
               "type" : "wikipedia",
               "value" : "http://en.wikipedia.org/wiki/United_States_Department_of_Energy"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "US",
                  "country_name" : "United States",
                  "lat" : 38.89511,
                  "lng" : -77.03637,
                  "name" : "Washington"
               },
               "geonames_id" : 4140963
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "acronym"
               ],
               "value" : "DOE"
            },
            {
               "lang" : "es",
               "types" : [
                  "label"
               ],
               "value" : "Departamento de Energía de los Estados Unidos"
            },
            {
               "lang" : "fr",
               "types" : [
                  "label"
               ],
               "value" : "Département de l'Énergie des États-unis"
            },
            {
               "lang" : null,
               "types" : [
                  "alias"
               ],
               "value" : "U.S. Department of Energy"
            },
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "United States Department of Energy"
            }
         ],
         "relationships" : [
            {
               "id" : "https://ror.org/03q1rgc19",
               "label" : "Advanced Research Projects Agency - Energy",
               "type" : "child"
            },
            {
               "id" : "https://ror.org/00qq8bd87",
               "label" : "Consortium for the Advanced Simulation of Light Water Reactors",
               "type" : "child"
            },
            {
               "id" : "https://ror.org/01ca2by25",
               "label" : "Great Lakes Bioenergy Research Center",
               "type" : "child"
            },
            {
               "id" : "https://ror.org/04d8cf622",
               "label" : "International Partnership for the Hydrogen and Fuel Cell in the Economy",
               "type" : "child"
            },
            {
               "id" : "https://ror.org/03ww55028",
               "label" : "Joint BioEnergy Institute",
               "type" : "child"
            },
            {
               "id" : "https://ror.org/03sk1we31",
               "label" : "National Nuclear Security Administration",
               "type" : "child"
            },
            {
               "id" : "https://ror.org/037k8mg80",
               "label" : "Nevada National Security Site",
               "type" : "child"
            },
            {
               "id" : "https://ror.org/05hsv7e61",
               "label" : "Office of Economic Impact and Diversity",
               "type" : "child"
            },
            {
               "id" : "https://ror.org/02xznz413",
               "label" : "Office of Energy Efficiency and Renewable Energy",
               "type" : "child"
            },
            {
               "id" : "https://ror.org/00km40770",
               "label" : "Office of Environmental Management",
               "type" : "child"
            },
            {
               "id" : "https://ror.org/01c9ay627",
               "label" : "Office of Environmental Protection, Sustainability Support and Corporate Safety Analysis",
               "type" : "child"
            },
            {
               "id" : "https://ror.org/03ery9d53",
               "label" : "Office of Fossil Energy",
               "type" : "child"
            },
            {
               "id" : "https://ror.org/04nnxen11",
               "label" : "Office of Inspector General",
               "type" : "child"
            },
            {
               "id" : "https://ror.org/02z1qvq09",
               "label" : "Office of Intelligence and Counterintelligence",
               "type" : "child"
            },
            {
               "id" : "https://ror.org/05ek3m339",
               "label" : "Office of International Affairs",
               "type" : "child"
            },
            {
               "id" : "https://ror.org/03jf3w726",
               "label" : "Office of Legacy Management",
               "type" : "child"
            },
            {
               "id" : "https://ror.org/02ah1da87",
               "label" : "Office of Management",
               "type" : "child"
            },
            {
               "id" : "https://ror.org/05tj7dm33",
               "label" : "Office of Nuclear Energy",
               "type" : "child"
            },
            {
               "id" : "https://ror.org/00mmn6b08",
               "label" : "Office of Science",
               "type" : "child"
            },
            {
               "id" : "https://ror.org/04s778r16",
               "label" : "Office of Space and Defense Power Systems",
               "type" : "child"
            },
            {
               "id" : "https://ror.org/03eecgp81",
               "label" : "Office of Under Secretary of Energy for Science",
               "type" : "child"
            },
            {
               "id" : "https://ror.org/0054t4769",
               "label" : "Office of the General Counsel",
               "type" : "child"
            },
            {
               "id" : "https://ror.org/05hhm9a98",
               "label" : "Savannah River Operations Office",
               "type" : "child"
            },
            {
               "id" : "https://ror.org/01h04ms65",
               "label" : "U.S. Energy Information Administration",
               "type" : "child"
            },
            {
               "id" : "https://ror.org/048g3cy84",
               "label" : "Vera C. Rubin Observatory",
               "type" : "child"
            },
            {
               "id" : "https://ror.org/03e7mhc87",
               "label" : "Kansas City National Security Campus",
               "type" : "child"
            },
            {
               "id" : "https://ror.org/01t14bp54",
               "label" : "Environmental System Science Data Infrastructure for a Virtual Ecosystem",
               "type" : "child"
            },
            {
               "id" : "https://ror.org/00hvbwp12",
               "label" : "Office of the Chief Information Officer",
               "type" : "child"
            },
            {
               "id" : "https://ror.org/00htph268",
               "label" : "Office of Under Secretary for Science and Innovation",
               "type" : "child"
            },
            {
               "id" : "https://ror.org/02vg64e60",
               "label" : "Office of Technology Transitions",
               "type" : "child"
            },
            {
               "id" : "https://ror.org/028rfb880",
               "label" : "Office of Secretary of Energy",
               "type" : "child"
            },
            {
               "id" : "https://ror.org/00mw1dx44",
               "label" : "Office of Public Affairs",
               "type" : "child"
            },
            {
               "id" : "https://ror.org/05p9bjd64",
               "label" : "Office of Policy",
               "type" : "child"
            },
            {
               "id" : "https://ror.org/02bhbx726",
               "label" : "Office of Indian Energy Policy and Programs",
               "type" : "child"
            },
            {
               "id" : "https://ror.org/037897814",
               "label" : "Office of Fossil Energy and Carbon Management",
               "type" : "child"
            },
            {
               "id" : "https://ror.org/04csf5r20",
               "label" : "Office of Environment, Health, Safety and Security",
               "type" : "child"
            },
            {
               "id" : "https://ror.org/035fxjt55",
               "label" : "Office of Enterprise Assessments",
               "type" : "child"
            },
            {
               "id" : "https://ror.org/035sc8895",
               "label" : "Office of State and Community Energy Programs",
               "type" : "child"
            },
            {
               "id" : "https://ror.org/01zprx076",
               "label" : "Office of Federal Energy Management Programs",
               "type" : "child"
            },
            {
               "id" : "https://ror.org/00n4kg172",
               "label" : "Grid Deployment Office",
               "type" : "child"
            },
            {
               "id" : "https://ror.org/02y6dp041",
               "label" : "Office of Electricity",
               "type" : "child"
            },
            {
               "id" : "https://ror.org/041g4v832",
               "label" : "Office of Cybersecurity, Energy Security, and Emergency Response",
               "type" : "child"
            },
            {
               "id" : "https://ror.org/05cpnza27",
               "label" : "Office of Congressional and Intergovernmental Affairs",
               "type" : "child"
            },
            {
               "id" : "https://ror.org/040vxhp34",
               "label" : "Oak Ridge Institute for Science and Education",
               "type" : "child"
            },
            {
               "id" : "https://ror.org/00536t873",
               "label" : "Artificial Intelligence & Technology Office",
               "type" : "child"
            },
            {
               "id" : "https://ror.org/04rp4zh16",
               "label" : "Office of Clean Energy Demonstrations",
               "type" : "child"
            },
            {
               "id" : "https://ror.org/02rcrvv70",
               "label" : "Government of the United States of America",
               "type" : "parent"
            }
         ],
         "status" : "active",
         "types" : [
            "government"
         ]
      }
   ],
   "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" : 16
}

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

The response returns the second page of results of a keyword search for "Harvard" that includes records of all status types. Note that the number of results given is the total number of results, not the number of results on the page.

{
   "items" : [
      {
         "admin" : {
            "created" : {
               "date" : "2024-03-13",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2024-03-13",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : 1990,
         "external_ids" : [
            {
               "all" : [
                  "100013721"
               ],
               "preferred" : "100013721",
               "type" : "fundref"
            },
            {
               "all" : [
                  "Q7300869"
               ],
               "preferred" : "Q7300869",
               "type" : "wikidata"
            }
         ],
         "id" : "https://ror.org/05b0g2v72",
         "links" : [
            {
               "type" : "website",
               "value" : "https://rcc.harvard.edu"
            },
            {
               "type" : "wikipedia",
               "value" : "https://en.wikipedia.org/wiki/Real_Colegio_Complutense"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "US",
                  "country_name" : "United States",
                  "lat" : 42.3751,
                  "lng" : -71.10561,
                  "name" : "Cambridge"
               },
               "geonames_id" : 4931972
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "alias"
               ],
               "value" : "RCC at Harvard University"
            },
            {
               "lang" : null,
               "types" : [
                  "acronym"
               ],
               "value" : "RCCHU"
            },
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "Real Colegio Complutense"
            },
            {
               "lang" : null,
               "types" : [
                  "alias"
               ],
               "value" : "Real Colegio Complutense at Harvard University"
            }
         ],
         "relationships" : [
            {
               "id" : "https://ror.org/03vek6s52",
               "label" : "Harvard University",
               "type" : "parent"
            }
         ],
         "status" : "active",
         "types" : [
            "education"
         ]
      },
      {
         "admin" : {
            "created" : {
               "date" : "2018-11-14",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2021-03-17",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : null,
         "external_ids" : [
            {
               "all" : [
                  "grid.418411.9"
               ],
               "preferred" : "grid.418411.9",
               "type" : "grid"
            }
         ],
         "id" : "https://ror.org/005m2at17",
         "links" : [
            {
               "type" : "website",
               "value" : "http://www.massgeneral.org/emergencymedicine/education/residency.aspx?id=84&display=overview"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "US",
                  "country_name" : "United States",
                  "lat" : 42.335946,
                  "lng" : -71.107469,
                  "name" : "Boston"
               },
               "geonames_id" : 4930956
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "acronym"
               ],
               "value" : "HAEMR"
            },
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "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"
         ]
      },
      {
         "admin" : {
            "created" : {
               "date" : "2018-11-14",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2021-09-23",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : 1973,
         "external_ids" : [
            {
               "all" : [
                  "grid.455754.2"
               ],
               "preferred" : "grid.455754.2",
               "type" : "grid"
            },
            {
               "all" : [
                  "Q1133697"
               ],
               "preferred" : null,
               "type" : "wikidata"
            }
         ],
         "id" : "https://ror.org/03c3r2d17",
         "links" : [
            {
               "type" : "website",
               "value" : "https://pweb.cfa.harvard.edu/"
            },
            {
               "type" : "wikipedia",
               "value" : "https://en.wikipedia.org/wiki/Harvard%E2%80%93Smithsonian_Center_for_Astrophysics"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "US",
                  "country_name" : "United States",
                  "lat" : 42.381463,
                  "lng" : -71.128166,
                  "name" : "Cambridge"
               },
               "geonames_id" : 4931972
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "Center for Astrophysics Harvard & Smithsonian"
            },
            {
               "lang" : null,
               "types" : [
                  "acronym"
               ],
               "value" : "CfA"
            },
            {
               "lang" : null,
               "types" : [
                  "alias"
               ],
               "value" : "Harvard–Smithsonian Center for Astrophysics"
            }
         ],
         "relationships" : [
            {
               "id" : "https://ror.org/01mcvy510",
               "label" : "Harvard College Observatory",
               "type" : "child"
            },
            {
               "id" : "https://ror.org/04mh52z70",
               "label" : "Smithsonian Astrophysical Observatory",
               "type" : "child"
            },
            {
               "id" : "https://ror.org/03vek6s52",
               "label" : "Harvard University",
               "type" : "parent"
            },
            {
               "id" : "https://ror.org/01pp8nd67",
               "label" : "Smithsonian Institution",
               "type" : "parent"
            }
         ],
         "status" : "active",
         "types" : [
            "education"
         ]
      },
      {
         "admin" : {
            "created" : {
               "date" : "2018-11-14",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2021-03-17",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : 1996,
         "external_ids" : [
            {
               "all" : [
                  "grid.462829.3"
               ],
               "preferred" : "grid.462829.3",
               "type" : "grid"
            }
         ],
         "id" : "https://ror.org/04rkbns44",
         "links" : [
            {
               "type" : "website",
               "value" : "http://www.bhp.org.bw/"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "BW",
                  "country_name" : "Botswana",
                  "lat" : -24.65661,
                  "lng" : 25.923299,
                  "name" : "Gaborone"
               },
               "geonames_id" : 933773
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "acronym"
               ],
               "value" : "BHP"
            },
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "Botswana Harvard AIDS Institute Partnership"
            }
         ],
         "relationships" : [
            {
               "id" : "https://ror.org/03vek6s52",
               "label" : "Harvard University",
               "type" : "related"
            }
         ],
         "status" : "active",
         "types" : [
            "other"
         ]
      },
      {
         "admin" : {
            "created" : {
               "date" : "2022-03-17",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2022-09-21",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : 1872,
         "external_ids" : [
            {
               "all" : [
                  "100009403"
               ],
               "preferred" : "100009403",
               "type" : "fundref"
            },
            {
               "all" : [
                  "0000 0001 2293 3096"
               ],
               "preferred" : "0000 0001 2293 3096",
               "type" : "isni"
            },
            {
               "all" : [
                  "Q568666"
               ],
               "preferred" : "Q568666",
               "type" : "wikidata"
            }
         ],
         "id" : "https://ror.org/05xsxgs79",
         "links" : [
            {
               "type" : "website",
               "value" : "http://www.arboretum.harvard.edu/"
            },
            {
               "type" : "wikipedia",
               "value" : "https://en.wikipedia.org/wiki/Arnold_Arboretum"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "US",
                  "country_name" : "United States",
                  "lat" : 42.35843,
                  "lng" : -71.05977,
                  "name" : "Boston"
               },
               "geonames_id" : 4930956
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "Arnold Arboretum"
            },
            {
               "lang" : null,
               "types" : [
                  "alias"
               ],
               "value" : "Arnold Arboretum of Harvard University"
            }
         ],
         "relationships" : [
            {
               "id" : "https://ror.org/03vek6s52",
               "label" : "Harvard University",
               "type" : "parent"
            }
         ],
         "status" : "active",
         "types" : [
            "archive"
         ]
      },
      {
         "admin" : {
            "created" : {
               "date" : "2018-11-14",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2023-12-20",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : 1973,
         "external_ids" : [
            {
               "all" : [
                  "100008126"
               ],
               "preferred" : "100008126",
               "type" : "fundref"
            },
            {
               "all" : [
                  "grid.477947.e"
               ],
               "preferred" : "grid.477947.e",
               "type" : "grid"
            },
            {
               "all" : [
                  "0000 0004 5902 1762"
               ],
               "preferred" : null,
               "type" : "isni"
            },
            {
               "all" : [
                  "Q30270475"
               ],
               "preferred" : "Q30270475",
               "type" : "wikidata"
            }
         ],
         "id" : "https://ror.org/03pvyf116",
         "links" : [
            {
               "type" : "website",
               "value" : "https://www.dfhcc.harvard.edu"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "US",
                  "country_name" : "United States",
                  "lat" : 42.35843,
                  "lng" : -71.05977,
                  "name" : "Boston"
               },
               "geonames_id" : 4930956
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "acronym"
               ],
               "value" : "DF/HCC"
            },
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "Dana-Farber/Harvard Cancer Center"
            }
         ],
         "relationships" : [
            {
               "id" : "https://ror.org/03vek6s52",
               "label" : "Harvard University",
               "type" : "parent"
            },
            {
               "id" : "https://ror.org/02jzgtq86",
               "label" : "Dana-Farber Cancer Institute",
               "type" : "parent"
            }
         ],
         "status" : "active",
         "types" : [
            "healthcare"
         ]
      },
      {
         "admin" : {
            "created" : {
               "date" : "2020-12-21",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2022-10-20",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : null,
         "external_ids" : [
            {
               "all" : [
                  "100019611"
               ],
               "preferred" : "100019611",
               "type" : "fundref"
            },
            {
               "all" : [
                  "grid.509519.1"
               ],
               "preferred" : "grid.509519.1",
               "type" : "grid"
            }
         ],
         "id" : "https://ror.org/053tmcn30",
         "links" : [
            {
               "type" : "website",
               "value" : "http://cuaweb.mit.edu/"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "US",
                  "country_name" : "United States",
                  "lat" : 42.3751,
                  "lng" : -71.10561,
                  "name" : "Cambridge"
               },
               "geonames_id" : 4931972
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "acronym"
               ],
               "value" : "CUA"
            },
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "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"
         ]
      },
      {
         "admin" : {
            "created" : {
               "date" : "2018-11-14",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2024-03-13",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : 2004,
         "external_ids" : [
            {
               "all" : [
                  "100013114"
               ],
               "preferred" : "100013114",
               "type" : "fundref"
            },
            {
               "all" : [
                  "grid.66859.34"
               ],
               "preferred" : "grid.66859.34",
               "type" : "grid"
            },
            {
               "all" : [
                  "0000 0004 0546 1623"
               ],
               "preferred" : "0000 0004 0546 1623",
               "type" : "isni"
            },
            {
               "all" : [
                  "Q4971893"
               ],
               "preferred" : null,
               "type" : "wikidata"
            }
         ],
         "id" : "https://ror.org/05a0ya142",
         "links" : [
            {
               "type" : "website",
               "value" : "http://www.broadinstitute.org/"
            },
            {
               "type" : "wikipedia",
               "value" : "http://en.wikipedia.org/wiki/Broad_Institute"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "US",
                  "country_name" : "United States",
                  "lat" : 42.3751,
                  "lng" : -71.10561,
                  "name" : "Cambridge"
               },
               "geonames_id" : 4931972
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "Broad Institute"
            },
            {
               "lang" : null,
               "types" : [
                  "alias"
               ],
               "value" : "Broad Institute of MIT and Harvard"
            },
            {
               "lang" : "es",
               "types" : [
                  "label"
               ],
               "value" : "El Instituto Broad"
            },
            {
               "lang" : null,
               "types" : [
                  "alias"
               ],
               "value" : "Eli and Edythe L. Broad Institute of MIT and Harvard"
            }
         ],
         "relationships" : [
            {
               "id" : "https://ror.org/01tm9b530",
               "label" : "Stanley Center for Psychiatric Research",
               "type" : "child"
            },
            {
               "id" : "https://ror.org/04drvxt59",
               "label" : "Beth Israel Deaconess Medical Center",
               "type" : "related"
            },
            {
               "id" : "https://ror.org/00dvg7y05",
               "label" : "Boston Children's Hospital",
               "type" : "related"
            },
            {
               "id" : "https://ror.org/04b6nzv94",
               "label" : "Brigham and Women's Hospital",
               "type" : "related"
            },
            {
               "id" : "https://ror.org/03vek6s52",
               "label" : "Harvard University",
               "type" : "related"
            },
            {
               "id" : "https://ror.org/002pd6e78",
               "label" : "Massachusetts General Hospital",
               "type" : "related"
            },
            {
               "id" : "https://ror.org/042nb2s44",
               "label" : "Massachusetts Institute of Technology",
               "type" : "related"
            }
         ],
         "status" : "active",
         "types" : [
            "nonprofit"
         ]
      },
      {
         "admin" : {
            "created" : {
               "date" : "2018-11-14",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2022-09-21",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : 2009,
         "external_ids" : [
            {
               "all" : [
                  "100012802"
               ],
               "preferred" : "100012802",
               "type" : "fundref"
            },
            {
               "all" : [
                  "grid.461656.6"
               ],
               "preferred" : "grid.461656.6",
               "type" : "grid"
            },
            {
               "all" : [
                  "0000 0004 0489 3491"
               ],
               "preferred" : null,
               "type" : "isni"
            },
            {
               "all" : [
                  "Q7185824"
               ],
               "preferred" : null,
               "type" : "wikidata"
            }
         ],
         "id" : "https://ror.org/053r20n13",
         "links" : [
            {
               "type" : "website",
               "value" : "http://ragoninstitute.org/"
            },
            {
               "type" : "wikipedia",
               "value" : "https://en.wikipedia.org/wiki/Phillip_T._and_Susan_M._Ragon_Institute"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "US",
                  "country_name" : "United States",
                  "lat" : 42.3751,
                  "lng" : -71.10561,
                  "name" : "Cambridge"
               },
               "geonames_id" : 4931972
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "alias"
               ],
               "value" : "Phillip T. and Susan M. Ragon Institute"
            },
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "Ragon Institute of MGH, MIT and Harvard"
            },
            {
               "lang" : null,
               "types" : [
                  "alias"
               ],
               "value" : "Ragon Institute of Massachusetts General Hospital, Massachusetts Institute of Technology and Harvard University"
            }
         ],
         "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"
         ]
      },
      {
         "admin" : {
            "created" : {
               "date" : "2018-11-14",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2021-03-17",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : 1970,
         "external_ids" : [
            {
               "all" : [
                  "grid.413735.7"
               ],
               "preferred" : "grid.413735.7",
               "type" : "grid"
            },
            {
               "all" : [
                  "0000 0004 0475 2760"
               ],
               "preferred" : null,
               "type" : "isni"
            },
            {
               "all" : [
                  "Q5676651"
               ],
               "preferred" : null,
               "type" : "wikidata"
            }
         ],
         "id" : "https://ror.org/00jjeh629",
         "links" : [
            {
               "type" : "website",
               "value" : "http://hst.mit.edu/"
            },
            {
               "type" : "wikipedia",
               "value" : "https://en.wikipedia.org/wiki/Harvard%E2%80%93MIT_Division_of_Health_Sciences_and_Technology"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "US",
                  "country_name" : "United States",
                  "lat" : 42.361777,
                  "lng" : -71.086911,
                  "name" : "Cambridge"
               },
               "geonames_id" : 4931972
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "acronym"
               ],
               "value" : "HST"
            },
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "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"
         ]
      },
      {
         "admin" : {
            "created" : {
               "date" : "2021-09-23",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2021-09-23",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : 2017,
         "external_ids" : [
            {
               "all" : [
                  "grid.511416.6"
               ],
               "preferred" : "grid.511416.6",
               "type" : "grid"
            },
            {
               "all" : [
                  "Q41498028"
               ],
               "preferred" : null,
               "type" : "wikidata"
            }
         ],
         "id" : "https://ror.org/00xj7pv34",
         "links" : [
            {
               "type" : "website",
               "value" : "https://www.archaeoscience.org/"
            },
            {
               "type" : "wikipedia",
               "value" : "https://en.wikipedia.org/wiki/Max_Planck_Harvard_Research_Center_for_the_Archaeoscience_of_the_Ancient_Mediterranean"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "DE",
                  "country_name" : "Germany",
                  "lat" : 50.927222,
                  "lng" : 11.586111,
                  "name" : "Jena"
               },
               "geonames_id" : 2895044
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "acronym"
               ],
               "value" : "MHAAM"
            },
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "Max Planck - Harvard Research Center for the Archaeoscience of the Ancient Mediterranean"
            }
         ],
         "relationships" : [],
         "status" : "active",
         "types" : [
            "facility"
         ]
      }
   ],
   "meta" : {
      "countries" : [
         {
            "count" : 27,
            "id" : "us",
            "title" : "United States"
         },
         {
            "count" : 2,
            "id" : "de",
            "title" : "Germany"
         },
         {
            "count" : 1,
            "id" : "au",
            "title" : "Australia"
         },
         {
            "count" : 1,
            "id" : "bw",
            "title" : "Botswana"
         }
      ],
      "statuses" : [
         {
            "count" : 29,
            "id" : "active",
            "title" : "active"
         },
         {
            "count" : 1,
            "id" : "inactive",
            "title" : "inactive"
         },
         {
            "count" : 1,
            "id" : "withdrawn",
            "title" : "withdrawn"
         }
      ],
      "types" : [
         {
            "count" : 6,
            "id" : "education",
            "title" : "education"
         },
         {
            "count" : 6,
            "id" : "facility",
            "title" : "facility"
         },
         {
            "count" : 6,
            "id" : "other",
            "title" : "other"
         },
         {
            "count" : 5,
            "id" : "healthcare",
            "title" : "healthcare"
         },
         {
            "count" : 5,
            "id" : "nonprofit",
            "title" : "nonprofit"
         },
         {
            "count" : 2,
            "id" : "company",
            "title" : "company"
         },
         {
            "count" : 1,
            "id" : "archive",
            "title" : "archive"
         }
      ]
   },
   "number_of_results" : 31,
   "time_taken" : 145
}

Example

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

The response returns a list of research organizations in the country of Jordan whose names include the keyword "Technology." Note that the v2 field name locations.geonames_details.country_name is interchangeable with the field name country.country_name.

{
   "items" : [
      {
         "admin" : {
            "created" : {
               "date" : "2018-11-14",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2023-05-25",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : 1991,
         "external_ids" : [
            {
               "all" : [
                  "grid.29251.3d"
               ],
               "preferred" : "grid.29251.3d",
               "type" : "grid"
            },
            {
               "all" : [
                  "0000 0004 0404 9637"
               ],
               "preferred" : null,
               "type" : "isni"
            },
            {
               "all" : [
                  "Q3551722"
               ],
               "preferred" : null,
               "type" : "wikidata"
            }
         ],
         "id" : "https://ror.org/01jy46q10",
         "links" : [
            {
               "type" : "website",
               "value" : "https://www.psut.edu.jo"
            },
            {
               "type" : "wikipedia",
               "value" : "http://en.wikipedia.org/wiki/Princess_Sumaya_University_for_Technology"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "JO",
                  "country_name" : "Jordan",
                  "lat" : 31.95522,
                  "lng" : 35.94503,
                  "name" : "Amman"
               },
               "geonames_id" : 250441
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "acronym"
               ],
               "value" : "PSUT"
            },
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "Princess Sumaya University for Technology"
            },
            {
               "lang" : "ar",
               "types" : [
                  "label"
               ],
               "value" : "جامعة الأميرة سمية للتكنولوجيا"
            }
         ],
         "relationships" : [],
         "status" : "active",
         "types" : [
            "education"
         ]
      },
      {
         "admin" : {
            "created" : {
               "date" : "2018-11-14",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2023-06-22",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : 1986,
         "external_ids" : [
            {
               "all" : [
                  "501100004035",
                  "501100019004"
               ],
               "preferred" : null,
               "type" : "fundref"
            },
            {
               "all" : [
                  "grid.37553.37"
               ],
               "preferred" : "grid.37553.37",
               "type" : "grid"
            },
            {
               "all" : [
                  "0000 0001 0097 5797"
               ],
               "preferred" : null,
               "type" : "isni"
            },
            {
               "all" : [
                  "Q2919325"
               ],
               "preferred" : null,
               "type" : "wikidata"
            }
         ],
         "id" : "https://ror.org/03y8mtb59",
         "links" : [
            {
               "type" : "website",
               "value" : "http://www.just.edu.jo/Pages/Default.aspx"
            },
            {
               "type" : "wikipedia",
               "value" : "http://en.wikipedia.org/wiki/Jordan_University_of_Science_and_Technology"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "JO",
                  "country_name" : "Jordan",
                  "lat" : 32.55556,
                  "lng" : 35.85,
                  "name" : "Irbid"
               },
               "geonames_id" : 248946
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "acronym"
               ],
               "value" : "JUST"
            },
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "Jordan University of Science and Technology"
            },
            {
               "lang" : "ar",
               "types" : [
                  "label"
               ],
               "value" : "جامعة العلوم والتكنولوجيا الأردنية"
            }
         ],
         "relationships" : [
            {
               "id" : "https://ror.org/02f2g4464",
               "label" : "Jordan Research and Training Reactor",
               "type" : "child"
            },
            {
               "id" : "https://ror.org/02f6hdc06",
               "label" : "King Abdullah University Hospital",
               "type" : "related"
            },
            {
               "id" : "https://ror.org/01fafm680",
               "label" : "Specialty Hospital, Jordan",
               "type" : "related"
            }
         ],
         "status" : "active",
         "types" : [
            "education"
         ]
      },
      {
         "admin" : {
            "created" : {
               "date" : "2018-11-14",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2024-02-13",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : 1987,
         "external_ids" : [
            {
               "all" : [
                  "501100010300"
               ],
               "preferred" : "501100010300",
               "type" : "fundref"
            },
            {
               "all" : [
                  "grid.438384.0"
               ],
               "preferred" : "grid.438384.0",
               "type" : "grid"
            }
         ],
         "id" : "https://ror.org/05bhjm183",
         "links" : [
            {
               "type" : "website",
               "value" : "http://hcst.gov.jo/"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "JO",
                  "country_name" : "Jordan",
                  "lat" : 32.01071,
                  "lng" : 35.89802,
                  "name" : "Al Jubayhah"
               },
               "geonames_id" : 250637
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "acronym"
               ],
               "value" : "HCST"
            },
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "Higher Council for Science and Technology"
            }
         ],
         "relationships" : [
            {
               "id" : "https://ror.org/044wgz941",
               "label" : "National Center for Research and Development",
               "type" : "child"
            }
         ],
         "status" : "active",
         "types" : [
            "other"
         ]
      }
   ],
   "meta" : {
      "countries" : [
         {
            "count" : 3,
            "id" : "jo",
            "title" : "Jordan"
         }
      ],
      "statuses" : [
         {
            "count" : 3,
            "id" : "active",
            "title" : "active"
         }
      ],
      "types" : [
         {
            "count" : 2,
            "id" : "education",
            "title" : "education"
         },
         {
            "count" : 1,
            "id" : "other",
            "title" : "other"
         }
      ]
   },
   "number_of_results" : 3,
   "time_taken" : 22
}

Example

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

The response returns a single research facility in Great Britain whose name contains the keyword "Bath". Note that the v2 field name locations.geonames_details.country_code is interchangeable with the field name country.country_code.

{
   "items" : [
      {
         "admin" : {
            "created" : {
               "date" : "2018-11-14",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2021-03-17",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : 2003,
         "external_ids" : [
            {
               "all" : [
                  "grid.432411.1"
               ],
               "preferred" : "grid.432411.1",
               "type" : "grid"
            }
         ],
         "id" : "https://ror.org/04hf68923",
         "links" : [
            {
               "type" : "website",
               "value" : "http://www.bathlabs.com/"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "GB",
                  "country_name" : "United Kingdom",
                  "lat" : 51.386501,
                  "lng" : -2.364442,
                  "name" : "Bath"
               },
               "geonames_id" : 2656173
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "Bath Labs"
            }
         ],
         "relationships" : [],
         "status" : "active",
         "types" : [
            "facility"
         ]
      }
   ],
   "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" : 124
}

Example

curl 'https://api.ror.org/v2/organizations?query=Osaka&filter=status:inactive,locations.geonames_details.country_name:Japan' | json_pp

The response returns a list of inactive research organizations in Japan whose names contain the keyword "Osaka". Note that the v2 field name locations.geonames_details.country_name is interchangeable with the field name country.country_name.

{
   "items" : [
      {
         "admin" : {
            "created" : {
               "date" : "2018-11-14",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2022-12-01",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : 1880,
         "external_ids" : [
            {
               "all" : [
                  "100015062"
               ],
               "preferred" : "100015062",
               "type" : "fundref"
            },
            {
               "all" : [
                  "grid.261445.0"
               ],
               "preferred" : "grid.261445.0",
               "type" : "grid"
            },
            {
               "all" : [
                  "0000 0001 1009 6411"
               ],
               "preferred" : null,
               "type" : "isni"
            },
            {
               "all" : [
                  "Q1143396"
               ],
               "preferred" : null,
               "type" : "wikidata"
            }
         ],
         "id" : "https://ror.org/02skfsw40",
         "links" : [
            {
               "type" : "website",
               "value" : "http://www.osaka-cu.ac.jp/en"
            },
            {
               "type" : "wikipedia",
               "value" : "http://en.wikipedia.org/wiki/Osaka_City_University"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "JP",
                  "country_name" : "Japan",
                  "lat" : 34.69374,
                  "lng" : 135.50218,
                  "name" : "Osaka"
               },
               "geonames_id" : 1853909
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "acronym"
               ],
               "value" : "OCU"
            },
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "Osaka City University"
            },
            {
               "lang" : null,
               "types" : [
                  "alias"
               ],
               "value" : "Ōsaka shiritsu daigaku"
            },
            {
               "lang" : "ja",
               "types" : [
                  "label"
               ],
               "value" : "大阪市立大学"
            }
         ],
         "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"
         ]
      },
      {
         "admin" : {
            "created" : {
               "date" : "2018-11-14",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2022-12-01",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : 1883,
         "external_ids" : [
            {
               "all" : [
                  "grid.261455.1"
               ],
               "preferred" : "grid.261455.1",
               "type" : "grid"
            },
            {
               "all" : [
                  "0000 0001 0676 0594"
               ],
               "preferred" : null,
               "type" : "isni"
            },
            {
               "all" : [
                  "Q290456"
               ],
               "preferred" : null,
               "type" : "wikidata"
            }
         ],
         "id" : "https://ror.org/02cf1je33",
         "links" : [
            {
               "type" : "website",
               "value" : "http://www.osakafu-u.ac.jp/english/"
            },
            {
               "type" : "wikipedia",
               "value" : "http://en.wikipedia.org/wiki/Osaka_Prefecture_University"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "JP",
                  "country_name" : "Japan",
                  "lat" : 34.58333,
                  "lng" : 135.46667,
                  "name" : "Sakai"
               },
               "geonames_id" : 1853195
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "acronym"
               ],
               "value" : "OPU"
            },
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "Osaka Prefecture University"
            },
            {
               "lang" : null,
               "types" : [
                  "alias"
               ],
               "value" : "Ōsaka furitsu daigaku"
            },
            {
               "lang" : "ja",
               "types" : [
                  "label"
               ],
               "value" : "大阪府立大学"
            }
         ],
         "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"
         ]
      },
      {
         "admin" : {
            "created" : {
               "date" : "2018-11-14",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2022-12-01",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : 1985,
         "external_ids" : [
            {
               "all" : [
                  "grid.471885.7"
               ],
               "preferred" : "grid.471885.7",
               "type" : "grid"
            },
            {
               "all" : [
                  "0000 0000 9356 4825"
               ],
               "preferred" : null,
               "type" : "isni"
            }
         ],
         "id" : "https://ror.org/01kjjpm11",
         "links" : [
            {
               "type" : "website",
               "value" : "http://www.meijo.ac.jp/about/education.html"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "JP",
                  "country_name" : "Japan",
                  "lat" : 34.69374,
                  "lng" : 135.50218,
                  "name" : "Osaka"
               },
               "geonames_id" : 1853909
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "Osaka Meijo Women's College"
            },
            {
               "lang" : null,
               "types" : [
                  "alias"
               ],
               "value" : "Osakameijojoshitankidaigaku"
            },
            {
               "lang" : "ja",
               "types" : [
                  "label"
               ],
               "value" : "大阪明浄女子短期大学"
            }
         ],
         "relationships" : [],
         "status" : "inactive",
         "types" : [
            "education"
         ]
      },
      {
         "admin" : {
            "created" : {
               "date" : "2018-11-14",
               "schema_version" : "1.0"
            },
            "last_modified" : {
               "date" : "2022-12-01",
               "schema_version" : "2.0"
            }
         },
         "domains" : [],
         "established" : 1955,
         "external_ids" : [
            {
               "all" : [
                  "grid.471938.0"
               ],
               "preferred" : "grid.471938.0",
               "type" : "grid"
            },
            {
               "all" : [
                  "0000 0004 0643 0001"
               ],
               "preferred" : null,
               "type" : "isni"
            },
            {
               "all" : [
                  "Q7105627"
               ],
               "preferred" : null,
               "type" : "wikidata"
            }
         ],
         "id" : "https://ror.org/01wtn4904",
         "links" : [
            {
               "type" : "website",
               "value" : "https://www.owjc.jp/"
            },
            {
               "type" : "wikipedia",
               "value" : "https://en.wikipedia.org/wiki/Osaka_Women%27s_Junior_College"
            }
         ],
         "locations" : [
            {
               "geonames_details" : {
                  "country_code" : "JP",
                  "country_name" : "Japan",
                  "lat" : 34.69374,
                  "lng" : 135.50218,
                  "name" : "Osaka"
               },
               "geonames_id" : 1853909
            }
         ],
         "names" : [
            {
               "lang" : null,
               "types" : [
                  "ror_display",
                  "label"
               ],
               "value" : "Osaka Women's Junior College"
            },
            {
               "lang" : null,
               "types" : [
                  "alias"
               ],
               "value" : "Ōsaka joshi tanki daigaku"
            },
            {
               "lang" : "ja",
               "types" : [
                  "label"
               ],
               "value" : "大阪女子短期大学"
            }
         ],
         "relationships" : [],
         "status" : "inactive",
         "types" : [
            "education"
         ]
      }
   ],
   "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" : 5
}

Technical details

The query parameter searches abbreviated Elasticsearch documents (called names_ids) that combine all the values from each ROR record's names and external_ids fields. 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"
            },
...

Other resources you might find helpful