The ROR API allows to retrieve, search and filter the organizations indexed in ROR. The results are returned in JSON. No registration is required to use the ROR API, but note that the rate limit is a maximum of 2000 requests in a 5-minute period, and API traffic can be quite heavy at popular times like midnight UTC. You can also run the entire ROR API locally in Docker.

📘

ROR API Status

Is the ROR API up? Check our status page https://status.ror.org

Retrieve a single organization record by ROR ID

Retrieve a single ROR record by its ROR ID using the format https://api.ror.org/organizations/<ror id> .

📘

When retrieving a single record, you use any of these formats in the ID portion of your request:

All formats will return the same record.

curl https://api.ror.org/organizations/015w2mp89

The response is a JSON object containing a full ROR record. See ROR data structure for details about the fields and values in a ROR record.

{
   "acronyms" : [
      "NPL"
   ],
   "addresses" : [
      {
         "city" : "London",
         "country_geonames_id" : 2635167,
         "geonames_city" : {
            "city" : "London",
            "geonames_admin1" : {
               "ascii_name" : "England",
               "code" : "GB.ENG",
               "id" : 6269131,
               "name" : "England"
            },
            "geonames_admin2" : {
               "ascii_name" : "Greater London",
               "code" : "GB.ENG.GLA",
               "id" : 2648110,
               "name" : "Greater London"
            },
            "id" : 2643743,
            "license" : {
               "attribution" : "Data from geonames.org under a CC-BY 3.0 license",
               "license" : "http://creativecommons.org/licenses/by/3.0/"
            },
            "nuts_level1" : {
               "code" : "UKI",
               "name" : "LONDON"
            },
            "nuts_level2" : {
               "code" : "UKI3",
               "name" : "Inner London - West"
            },
            "nuts_level3" : {
               "code" : "UKI32",
               "name" : "Westminster"
            }
         },
         "lat" : 51.427184,
         "line" : null,
         "lng" : -0.344256,
         "postcode" : null,
         "primary" : false,
         "state" : null,
         "state_code" : null
      }
   ],
   "aliases" : [],
   "country" : {
      "country_code" : "GB",
      "country_name" : "United Kingdom"
   },
   "email_address" : null,
   "established" : 1900,
   "external_ids" : {
      "GRID" : {
         "all" : "grid.410351.2",
         "preferred" : "grid.410351.2"
      },
      "ISNI" : {
         "all" : [
            "0000 0000 8991 6349"
         ],
         "preferred" : null
      },
      "OrgRef" : {
         "all" : [
            "250381"
         ],
         "preferred" : null
      },
      "Wikidata" : {
         "all" : [
            "Q1967606"
         ],
         "preferred" : null
      }
   },
   "id" : "https://ror.org/015w2mp89",
   "ip_addresses" : [],
   "labels" : [],
   "links" : [
      "http://www.npl.co.uk/"
   ],
   "name" : "National Physical Laboratory",
   "relationships" : [],
   "status" : "active",
   "types" : [
      "Facility"
   ],
   "wikipedia_url" : "http://en.wikipedia.org/wiki/National_Physical_Laboratory_(United_Kingdom)"
}

Retrieve a list of organizations records

Retrieve the first 10,000 organizations in the ROR search index (paginated, with 20 records on each page), along with summary metadata such as counts of organization by country and type. Note that due to Elastic Search limitations, you cannot retrieve the entire ROR datasets from the API.

❗️

It is not possible to retrieve all ROR records from the API

Elastic Search has an inherent upper limit of 10,000 results, which means that it is currently not possible to retrieve all 100,000+ records from the ROR API. If you need to use the entire ROR dataset in your application, please download the data dump.

📘

Filtering

This request can be filtered by the organization's type or country. See Filtering below for information about filtering results.

curl https://api.ror.org/organizations

The response is a JSON object containing full records for the first 20 organizations in ROR in the items array and metadata about the entire dataset in the metadata array. See ROR data structure for details about the fields and values in a ROR record.

{
   "items" : [
      {
         "acronyms" : [
            "TSU"
         ],
         "addresses" : [
            {
               "city" : "Houston",
               "country_geonames_id" : 6252001,
               "geonames_city" : {
                  "city" : "Houston",
                  "geonames_admin1" : {
                     "ascii_name" : "Texas",
                     "code" : "US.TX",
                     "id" : 4736286,
                     "name" : "Texas"
                  },
                  "geonames_admin2" : {
                     "ascii_name" : "Harris County",
                     "code" : "US.TX.201",
                     "id" : 4696376,
                     "name" : "Harris County"
                  },
                  "id" : 4699066,
                  "license" : {
                     "attribution" : "Data from geonames.org under a CC-BY 3.0 license",
                     "license" : "http://creativecommons.org/licenses/by/3.0/"
                  },
                  "nuts_level1" : {
                     "code" : null,
                     "name" : null
                  },
                  "nuts_level2" : {
                     "code" : null,
                     "name" : null
                  },
                  "nuts_level3" : {
                     "code" : null,
                     "name" : null
                  }
               },
               "lat" : 29.722222,
               "line" : null,
               "lng" : -95.361111,
               "postcode" : null,
               "primary" : false,
               "state" : "Texas",
               "state_code" : "US-TX"
            }
         ],
         "aliases" : [],
         "country" : {
            "country_code" : "US",
            "country_name" : "United States"
         },
         "email_address" : "",
         "established" : 1927,
         "external_ids" : {
            "GRID" : {
               "all" : "grid.264771.1",
               "preferred" : "grid.264771.1"
            },
            "ISNI" : {
               "all" : [
                  "0000 0001 2173 6488"
               ],
               "preferred" : null
            },
            "OrgRef" : {
               "all" : [
                  "543894",
                  "7023657"
               ],
               "preferred" : "543894"
            },
            "Wikidata" : {
               "all" : [
                  "Q626591"
               ],
               "preferred" : null
            }
         },
         "id" : "https://ror.org/05ch0aw77",
         "ip_addresses" : [],
         "labels" : [],
         "links" : [
            "http://www.tsu.edu/about/"
         ],
         "name" : "Texas Southern University",
         "relationships" : [],
         "status" : "active",
         "types" : [
            "Education"
         ],
         "wikipedia_url" : "http://en.wikipedia.org/wiki/Texas_Southern_University"
      },
     ...
    ],
    "meta" : {
      "countries" : [
         {
            "count" : 30304,
            "id" : "us",
            "title" : "United States of America"
         },
         {
            "count" : 7273,
            "id" : "gb",
            "title" : "United Kingdom of Great Britain and Northern Ireland"
         },
         {
            "count" : 4855,
            "id" : "de",
            "title" : "Federal Republic of Germany"
         },
         {
            "count" : 4651,
            "id" : "cn",
            "title" : "People's Republic of China"
         },
         {
            "count" : 3885,
            "id" : "jp",
            "title" : "Japan"
         },
         {
            "count" : 3759,
            "id" : "fr",
            "title" : "French Republic"
         },
         {
            "count" : 3248,
            "id" : "ca",
            "title" : "Canada"
         },
         {
            "count" : 2917,
            "id" : "in",
            "title" : "Republic of India"
         },
         {
            "count" : 2739,
            "id" : "cz",
            "title" : "Czech Republic"
         },
         {
            "count" : 2019,
            "id" : "ru",
            "title" : "Russian Federation"
         }
      ],
      "types" : [
         {
            "count" : 29065,
            "id" : "company",
            "title" : "Company"
         },
         {
            "count" : 19639,
            "id" : "education",
            "title" : "Education"
         },
         {
            "count" : 13549,
            "id" : "nonprofit",
            "title" : "Nonprofit"
         },
         {
            "count" : 12689,
            "id" : "healthcare",
            "title" : "Healthcare"
         },
         {
            "count" : 8795,
            "id" : "facility",
            "title" : "Facility"
         },
         {
            "count" : 8003,
            "id" : "other",
            "title" : "Other"
         },
         {
            "count" : 5933,
            "id" : "government",
            "title" : "Government"
         },
         {
            "count" : 2766,
            "id" : "archive",
            "title" : "Archive"
         }
      ]
   },
   "number_of_results" : 100467,
   "time_taken" : 9
}

Search ROR records

There are 3 ways to search ROR records:

  • Query parameter: "Quick search" of values from name, aliases, labels, acronyms and external_ids fields only in ROR records. Works best for searching based on keywords in organization names or exact matches of a name or external identifier (using quotes).

  • Affiliation parameter: "Needle in a haystack" search designed to identify an organization when given a long search string that contains not just the organization's name, but also extraneous information such as address or the name of a department. Breaks search strings into multiple substrings at spaces and special characters, performs multiple searches of name-related fields only (name, aliases, labels and acronym) using several different search algorithms, and returns the best result(s) based on matching score using the format https://api.ror.org/organizations?affiliation=<URL-encoded string>. Requires at least 12 characters in the search string for best results.

  • Advanced search: Allows searching of any and all ROR record fields, including links and addresses and country. Complex queries using field names, wildcards, boolean operators, etc can be constructed using Elastic Search query string syntax.

Query parameter

"Quick search" of values from name, aliases, labels, acronyms and external identifiers fields in ROR records using the format https://api.ror.org/organizations?query=<search term>.

The value of the query parameter must be URL-encoded and Elasticsearch reserved characters such as &, (), / and : must be URL-encoded and escaped using a URL-encoded \ character. See Special characters below for more details.

📘

Paging

This request retrieves only the first 20 records. See Paging below for information about how to retrieve additional results.

curl https://api.ror.org/organizations?query=bath

Like with retrieving all organizations, the response is a JSON object containing full records for the first 20 search results.

{
   "items" : [
      {
         "acronyms" : [],
         "addresses" : [
            {
               "city" : "Bath",
               "country_geonames_id" : 2635167,
               "geonames_city" : {
                  "city" : "Bath",
                  "geonames_admin1" : {
                     "ascii_name" : "England",
                     "code" : "GB.ENG",
                     "id" : 6269131,
                     "name" : "England"
                  },
                  "geonames_admin2" : {
                     "ascii_name" : "Bath and North East Somerset",
                     "code" : "GB.ENG.A4",
                     "id" : 3333123,
                     "name" : "Bath and North East Somerset"
                  },
                  "id" : 2656173,
                  "license" : {
                     "attribution" : "Data from geonames.org under a CC-BY 3.0 license",
                     "license" : "http://creativecommons.org/licenses/by/3.0/"
                  },
                  "nuts_level1" : {
                     "code" : "UKK",
                     "name" : "SOUTH WEST (ENGLAND)"
                  },
                  "nuts_level2" : {
                     "code" : "UKK1",
                     "name" : "Gloucestershire, Wiltshire and Bristol/Bath area"
                  },
                  "nuts_level3" : {
                     "code" : "UKK12",
                     "name" : "Bath and North East Somerset, North Somerset and South Gloucestershire"
                  }
               },
               "lat" : 51.380148,
               "line" : null,
               "lng" : -2.362725,
               "postcode" : null,
               "primary" : false,
               "state" : null,
               "state_code" : null
            }
         ],
         "aliases" : [],
         "country" : {
            "country_code" : "GB",
            "country_name" : "United Kingdom"
         },
         "email_address" : null,
         "established" : 1892,
         "external_ids" : {
            "GRID" : {
               "all" : "grid.468747.e",
               "preferred" : "grid.468747.e"
            },
            "ISNI" : {
               "all" : [
                  "0000 0004 6437 268X"
               ],
               "preferred" : null
            },
            "OrgRef" : {
               "all" : [
                  "11933767"
               ],
               "preferred" : null
            },
            "Wikidata" : {
               "all" : [
                  "Q5123579"
               ],
               "preferred" : null
            }
         },
         "id" : "https://ror.org/00pbyj886",
         "ip_addresses" : [],
         "labels" : [],
         "links" : [
            "https://www.bathcollege.ac.uk/"
         ],
         "name" : "Bath College",
         "relationships" : [],
         "status" : "active",
         "types" : [
            "Education"
         ],
         "wikipedia_url" : "https://en.wikipedia.org/wiki/Bath_College"
      },
     ...
   ],
   "meta" : {
      "countries" : [
         {
            "count" : 12,
            "id" : "gb",
            "title" : "United Kingdom of Great Britain and Northern Ireland"
         },
         {
            "count" : 2,
            "id" : "us",
            "title" : "United States of America"
         },
         {
            "count" : 1,
            "id" : "ca",
            "title" : "Canada"
         }
      ],
      "types" : [
         {
            "count" : 4,
            "id" : "education",
            "title" : "Education"
         },
         {
            "count" : 3,
            "id" : "healthcare",
            "title" : "Healthcare"
         },
         {
            "count" : 3,
            "id" : "nonprofit",
            "title" : "Nonprofit"
         },
         {
            "count" : 1,
            "id" : "archive",
            "title" : "Archive"
         },
         {
            "count" : 1,
            "id" : "company",
            "title" : "Company"
         },
         {
            "count" : 1,
            "id" : "facility",
            "title" : "Facility"
         },
         {
            "count" : 1,
            "id" : "government",
            "title" : "Government"
         },
         {
            "count" : 1,
            "id" : "other",
            "title" : "Other"
         }
      ]
   },
   "number_of_results" : 15,
   "time_taken" : 14
}

📘

Filtering

This request can be filtered by the organization's type or country. See Filtering below for information about filtering results.

Affiliation parameter

"Needle in a haystack" search designed to identify an organization when given a long search string that contains not just the organization's name, but also extraneous information such as address or the name of a department. Breaks search strings into multiple substrings at spaces and special characters, performs multiple searches of name-related fields only (name, aliases, labels and acronym) using several different search algorithms, and returns the best result(s) based on matching score using the format https://api.ror.org/organizations?affiliation=<URL-encoded string>. Requires at least 12 characters in the search string for best results.

The value of the affiliation parameter must be URL-encoded.

curl https://api.ror.org/organizations?affiliation=Department%20of%20Civil%20and%20Industrial%20Engineering%2C%20University%20of%20Pisa%2C%20Largo%20Lucio%20Lazzarino%202%2C%20Pisa%2056126%2C%20Italy
curl https://api.ror.org/organizations?affiliation=UCL%20School%20of%20Slavonic%20and%20East%20European%20Studies

The response is a JSON object that contains an array of items with the following fields:

  • organization: ROR record for matched organization
  • substring: substring of the supplied string that generated this match
  • score: matching confidence score, with values between 0 and 1 (inclusive)
  • chosen: binary indicator of whether the score is high enough to consider the organization correctly matched
  • matching_type: type of matching algorithm applied in this case, possible values:
    • PHRASE: the entire phrase matched to a variant of the organization's name
    • COMMON TERMS: the matching was done by comparing the words separately
    • FUZZY: the matching was done by fuzzy-comparing the words separately
    • HEURISTICS: "University of X" was matched to "X University"
    • ACRONYM: matched by acronym

🚧

12-character minimum

Affiliation searches with search strings of less than 12 characters will only return results where the entire value of acronyms, name, aliases or label in the ROR record exactly matches a substring.

📘

Is it a match?

When using affiliation matching, look for results with "chosen": true if you want a simple approach to choosing the best match.

{
   "items" : [
      {
         "chosen" : true,
         "matching_type" : "PHRASE",
         "organization" : {
            "acronyms" : [
               "UniPi"
            ],
            "addresses" : [
               {
                  "city" : "Pisa",
                  "country_geonames_id" : 3175395,
                  "geonames_city" : {
                     "city" : "Pisa",
                     "geonames_admin1" : {
                        "ascii_name" : "Tuscany",
                        "code" : "IT.16",
                        "id" : 3165361,
                        "name" : "Tuscany"
                     },
                     "geonames_admin2" : {
                        "ascii_name" : "Province of Pisa",
                        "code" : "IT.16.PI",
                        "id" : 3170646,
                        "name" : "Province of Pisa"
                     },
                     "id" : 3170647,
                     "license" : {
                        "attribution" : "Data from geonames.org under a CC-BY 3.0 license",
                        "license" : "http://creativecommons.org/licenses/by/3.0/"
                     },
                     "nuts_level1" : {
                        "code" : "ITI",
                        "name" : "CENTRO (IT)"
                     },
                     "nuts_level2" : {
                        "code" : "ITI1",
                        "name" : "Toscana"
                     },
                     "nuts_level3" : {
                        "code" : "ITI17",
                        "name" : "Pisa"
                     }
                  },
                  "lat" : 43.716429,
                  "line" : null,
                  "lng" : 10.398687,
                  "postcode" : null,
                  "primary" : false,
                  "state" : "Toscana",
                  "state_code" : "IT-52"
               }
            ],
            "aliases" : [],
            "country" : {
               "country_code" : "IT",
               "country_name" : "Italy"
            },
            "email_address" : "",
            "established" : 1343,
            "external_ids" : {
               "FundRef" : {
                  "all" : [
                     "501100007514"
                  ],
                  "preferred" : null
               },
               "GRID" : {
                  "all" : "grid.5395.a",
                  "preferred" : "grid.5395.a"
               },
               "ISNI" : {
                  "all" : [
                     "0000 0004 1757 3729"
                  ],
                  "preferred" : null
               },
               "OrgRef" : {
                  "all" : [
                     "453158"
                  ],
                  "preferred" : null
               },
               "Wikidata" : {
                  "all" : [
                     "Q645663"
                  ],
                  "preferred" : null
               }
            },
            "id" : "https://ror.org/03ad39j10",
            "ip_addresses" : [],
            "labels" : [
               {
                  "iso639" : "fr",
                  "label" : "Université de Pise"
               },
               {
                  "iso639" : "de",
                  "label" : "Universität Pisa"
               },
               {
                  "iso639" : "it",
                  "label" : "Università di Pisa"
               }
            ],
            "links" : [
               "http://www.unipi.it/"
            ],
            "name" : "University of Pisa",
            "relationships" : [
               {
                  "id" : "https://ror.org/00mc91w09",
                  "label" : "Ospedale Cisanello",
                  "type" : "Related"
               }
            ],
            "status" : "active",
            "types" : [
               "Education"
            ],
            "wikipedia_url" : "http://en.wikipedia.org/wiki/University_of_Pisa"
         },
         "score" : 1,
         "substring" : "University of Pisa"
      },
      {
         "chosen" : false,
         "matching_type" : "COMMON TERMS",
         "organization" : {
            "acronyms" : [],
            "addresses" : [
               {
                  "city" : "Pisa",
                  "country_geonames_id" : 3175395,
                  "geonames_city" : {
                     "city" : "Pisa",
                     "geonames_admin1" : {
                        "ascii_name" : "Tuscany",
                        "code" : "IT.16",
                        "id" : 3165361,
                        "name" : "Tuscany"
                     },
                     "geonames_admin2" : {
                        "ascii_name" : "Province of Pisa",
                        "code" : "IT.16.PI",
                        "id" : 3170646,
                        "name" : "Province of Pisa"
                     },
                     "id" : 3170647,
                     "license" : {
                        "attribution" : "Data from geonames.org under a CC-BY 3.0 license",
                        "license" : "http://creativecommons.org/licenses/by/3.0/"
                     },
                     "nuts_level1" : {
                        "code" : "ITI",
                        "name" : "CENTRO (IT)"
                     },
                     "nuts_level2" : {
                        "code" : "ITI1",
                        "name" : "Toscana"
                     },
                     "nuts_level3" : {
                        "code" : "ITI17",
                        "name" : "Pisa"
                     }
                  },
                  "lat" : 43.721701,
                  "line" : null,
                  "lng" : 10.395694,
                  "postcode" : null,
                  "primary" : false,
                  "state" : null,
                  "state_code" : null
               }
            ],
            "aliases" : [],
            "country" : {
               "country_code" : "IT",
               "country_name" : "Italy"
            },
            "email_address" : null,
            "established" : null,
            "external_ids" : {
               "GRID" : {
                  "all" : "grid.144189.1",
                  "preferred" : "grid.144189.1"
               },
               "ISNI" : {
                  "all" : [
                     "0000 0004 1756 8209"
                  ],
                  "preferred" : null
               }
            },
            "id" : "https://ror.org/05xrcj819",
            "ip_addresses" : [],
            "labels" : [
               {
                  "iso639" : "en",
                  "label" : "University Hospital of Pisa"
               }
            ],
            "links" : [
               "http://www.ao-pisa.toscana.it/"
            ],
            "name" : "Azienda Ospedaliera Universitaria Pisana",
            "relationships" : [
               {
                  "id" : "https://ror.org/00mc91w09",
                  "label" : "Ospedale Cisanello",
                  "type" : "Child"
               }
            ],
            "status" : "active",
            "types" : [
               "Healthcare"
            ],
            "wikipedia_url" : ""
         },
         "score" : 0.8,
         "substring" : "University of Pisa"
      },
      {
         "chosen" : false,
         "matching_type" : "COMMON TERMS",
         "organization" : {
            "acronyms" : [],
            "addresses" : [
               {
                  "city" : "Rome",
                  "country_geonames_id" : 3175395,
                  "geonames_city" : {
                     "city" : "Rome",
                     "geonames_admin1" : {
                        "ascii_name" : "Latium",
                        "code" : "IT.07",
                        "id" : 3174976,
                        "name" : "Latium"
                     },
                     "geonames_admin2" : {
                        "ascii_name" : "Citta metropolitana di Roma Capitale",
                        "code" : "IT.07.RM",
                        "id" : 3169069,
                        "name" : "Città metropolitana di Roma Capitale"
                     },
                     "id" : 3169070,
                     "license" : {
                        "attribution" : "Data from geonames.org under a CC-BY 3.0 license",
                        "license" : "http://creativecommons.org/licenses/by/3.0/"
                     },
                     "nuts_level1" : {
                        "code" : "ITI",
                        "name" : "CENTRO (IT)"
                     },
                     "nuts_level2" : {
                        "code" : "ITI4",
                        "name" : "Lazio"
                     },
                     "nuts_level3" : {
                        "code" : "ITI43",
                        "name" : "Roma"
                     }
                  },
                  "lat" : 41.903575,
                  "line" : null,
                  "lng" : 12.472524,
                  "postcode" : null,
                  "primary" : false,
                  "state" : null,
                  "state_code" : null
               }
            ],
            "aliases" : [],
            "country" : {
               "country_code" : "IT",
               "country_name" : "Italy"
            },
            "email_address" : null,
            "established" : 1982,
            "external_ids" : {
               "GRID" : {
                  "all" : "grid.425554.7",
                  "preferred" : "grid.425554.7"
               },
               "ISNI" : {
                  "all" : [
                     "0000 0004 1773 7551"
                  ],
                  "preferred" : null
               }
            },
            "id" : "https://ror.org/050xp5d36",
            "ip_addresses" : [],
            "labels" : [
               {
                  "iso639" : "en",
                  "label" : "Civil Protection Department"
               }
            ],
            "links" : [
               "http://www.protezionecivile.gov.it/jcms/en/homepage.wp"
            ],
            "name" : "Dipartimento della Protezione Civile",
            "relationships" : [],
            "status" : "active",
            "types" : [
               "Government"
            ],
            "wikipedia_url" : ""
         },
         "score" : 0.78,
         "substring" : "Department of Civil"
      },
      {
         "chosen" : false,
         "matching_type" : "FUZZY",
         "organization" : {
            "acronyms" : [],
            "addresses" : [
               {
                  "city" : "Rome",
                  "country_geonames_id" : 3175395,
                  "geonames_city" : {
                     "city" : "Rome",
                     "geonames_admin1" : {
                        "ascii_name" : "Latium",
                        "code" : "IT.07",
                        "id" : 3174976,
                        "name" : "Latium"
                     },
                     "geonames_admin2" : {
                        "ascii_name" : "Citta metropolitana di Roma Capitale",
                        "code" : "IT.07.RM",
                        "id" : 3169069,
                        "name" : "Città metropolitana di Roma Capitale"
                     },
                     "id" : 3169070,
                     "license" : {
                        "attribution" : "Data from geonames.org under a CC-BY 3.0 license",
                        "license" : "http://creativecommons.org/licenses/by/3.0/"
                     },
                     "nuts_level1" : {
                        "code" : "ITI",
                        "name" : "CENTRO (IT)"
                     },
                     "nuts_level2" : {
                        "code" : "ITI4",
                        "name" : "Lazio"
                     },
                     "nuts_level3" : {
                        "code" : "ITI43",
                        "name" : "Roma"
                     }
                  },
                  "lat" : 41.899923,
                  "line" : null,
                  "lng" : 12.458225,
                  "postcode" : null,
                  "primary" : false,
                  "state" : null,
                  "state_code" : null
               }
            ],
            "aliases" : [
               "Urbaniana"
            ],
            "country" : {
               "country_code" : "IT",
               "country_name" : "Italy"
            },
            "email_address" : null,
            "established" : 1627,
            "external_ids" : {
               "GRID" : {
                  "all" : "grid.449323.b",
                  "preferred" : "grid.449323.b"
               },
               "ISNI" : {
                  "all" : [
                     "0000 0004 1797 7432"
                  ],
                  "preferred" : null
               },
               "OrgRef" : {
                  "all" : [
                     "7922067"
                  ],
                  "preferred" : null
               },
               "Wikidata" : {
                  "all" : [
                     "Q2032536"
                  ],
                  "preferred" : null
               }
            },
            "id" : "https://ror.org/01yjpt684",
            "ip_addresses" : [],
            "labels" : [
               {
                  "iso639" : "it",
                  "label" : "Pontificia Università Urbaniana"
               },
               {
                  "iso639" : "fr",
                  "label" : "Université pontificale urbaniana"
               },
               {
                  "iso639" : "de",
                  "label" : "Päpstliche Universität Urbaniana"
               }
            ],
            "links" : [
               "http://www.urbaniana.edu/"
            ],
            "name" : "Pontifical Urban University",
            "relationships" : [],
            "status" : "active",
            "types" : [
               "Education"
            ],
            "wikipedia_url" : "https://en.wikipedia.org/wiki/Pontifical_Urban_University"
         },
         "score" : 0.67,
         "substring" : "University of Pisa"
      },
      {
         "chosen" : false,
         "matching_type" : "FUZZY",
         "organization" : {
            "acronyms" : [
               "UNICAL"
            ],
            "addresses" : [
               {
                  "city" : "Rende",
                  "country_geonames_id" : 3175395,
                  "geonames_city" : {
                     "city" : "Rende",
                     "geonames_admin1" : {
                        "ascii_name" : "Calabria",
                        "code" : "IT.03",
                        "id" : 2525468,
                        "name" : "Calabria"
                     },
                     "geonames_admin2" : {
                        "ascii_name" : "Provincia di Cosenza",
                        "code" : "IT.03.CS",
                        "id" : 2524906,
                        "name" : "Provincia di Cosenza"
                     },
                     "id" : 2523623,
                     "license" : {
                        "attribution" : "Data from geonames.org under a CC-BY 3.0 license",
                        "license" : "http://creativecommons.org/licenses/by/3.0/"
                     },
                     "nuts_level1" : {
                        "code" : "ITF",
                        "name" : "SUD"
                     },
                     "nuts_level2" : {
                        "code" : "ITF6",
                        "name" : "Calabria"
                     },
                     "nuts_level3" : {
                        "code" : "ITF61",
                        "name" : "Cosenza"
                     }
                  },
                  "lat" : 39.358391,
                  "line" : null,
                  "lng" : 16.225531,
                  "postcode" : null,
                  "primary" : false,
                  "state" : null,
                  "state_code" : null
               }
            ],
            "aliases" : [],
            "country" : {
               "country_code" : "IT",
               "country_name" : "Italy"
            },
            "email_address" : null,
            "established" : 1972,
            "external_ids" : {
               "FundRef" : {
                  "all" : [
                     "501100007069"
                  ],
                  "preferred" : null
               },
               "GRID" : {
                  "all" : "grid.7778.f",
                  "preferred" : "grid.7778.f"
               },
               "ISNI" : {
                  "all" : [
                     "0000 0004 1937 0319"
                  ],
                  "preferred" : null
               },
               "OrgRef" : {
                  "all" : [
                     "1810404"
                  ],
                  "preferred" : null
               },
               "Wikidata" : {
                  "all" : [
                     "Q1752540"
                  ],
                  "preferred" : null
               }
            },
            "id" : "https://ror.org/02rc97e94",
            "ip_addresses" : [],
            "labels" : [
               {
                  "iso639" : "fr",
                  "label" : "Université de la calabre"
               },
               {
                  "iso639" : "de",
                  "label" : "Universität Kalabrien"
               },
               {
                  "iso639" : "it",
                  "label" : "Università della Calabria"
               }
            ],
            "links" : [
               "http://www.unical.it/portale/"
            ],
            "name" : "University of Calabria",
            "relationships" : [],
            "status" : "active",
            "types" : [
               "Education"
            ],
            "wikipedia_url" : "http://en.wikipedia.org/wiki/University_of_Calabria"
         },
         "score" : 0.65,
         "substring" : "University of Pisa"
      },
      {
         "chosen" : false,
         "matching_type" : "COMMON TERMS",
         "organization" : {
            "acronyms" : [],
            "addresses" : [
               {
                  "city" : "Pisa",
                  "country_geonames_id" : 3175395,
                  "geonames_city" : {
                     "city" : "Pisa",
                     "geonames_admin1" : {
                        "ascii_name" : "Tuscany",
                        "code" : "IT.16",
                        "id" : 3165361,
                        "name" : "Tuscany"
                     },
                     "geonames_admin2" : {
                        "ascii_name" : "Province of Pisa",
                        "code" : "IT.16.PI",
                        "id" : 3170646,
                        "name" : "Province of Pisa"
                     },
                     "id" : 3170647,
                     "license" : {
                        "attribution" : "Data from geonames.org under a CC-BY 3.0 license",
                        "license" : "http://creativecommons.org/licenses/by/3.0/"
                     },
                     "nuts_level1" : {
                        "code" : "ITI",
                        "name" : "CENTRO (IT)"
                     },
                     "nuts_level2" : {
                        "code" : "ITI1",
                        "name" : "Toscana"
                     },
                     "nuts_level3" : {
                        "code" : "ITI17",
                        "name" : "Pisa"
                     }
                  },
                  "lat" : 43.712468,
                  "line" : null,
                  "lng" : 10.399651,
                  "postcode" : null,
                  "primary" : false,
                  "state" : null,
                  "state_code" : null
               }
            ],
            "aliases" : [],
            "country" : {
               "country_code" : "IT",
               "country_name" : "Italy"
            },
            "email_address" : null,
            "established" : 1987,
            "external_ids" : {
               "GRID" : {
                  "all" : "grid.5740.6",
                  "preferred" : "grid.5740.6"
               },
               "ISNI" : {
                  "all" : [
                     "0000 0000 9120 5458"
                  ],
                  "preferred" : null
               },
               "Wikidata" : {
                  "all" : [
                     "Q30252673"
                  ],
                  "preferred" : null
               }
            },
            "id" : "https://ror.org/01t0n3b84",
            "ip_addresses" : [],
            "labels" : [],
            "links" : [
               "http://www.cpr.it/"
            ],
            "name" : "Consorzio Pisa Ricerche",
            "relationships" : [],
            "status" : "active",
            "types" : [
               "Facility"
            ],
            "wikipedia_url" : ""
         },
         "score" : 0.49,
         "substring" : "University of Pisa"
      },
      {
         "chosen" : false,
         "matching_type" : "COMMON TERMS",
         "organization" : {
            "acronyms" : [],
            "addresses" : [
               {
                  "city" : "Ivrea",
                  "country_geonames_id" : 3175395,
                  "geonames_city" : {
                     "city" : "Ivrea",
                     "geonames_admin1" : {
                        "ascii_name" : "Piedmont",
                        "code" : "IT.12",
                        "id" : 3170831,
                        "name" : "Piedmont"
                     },
                     "geonames_admin2" : {
                        "ascii_name" : "Torino",
                        "code" : "IT.12.TO",
                        "id" : 3165523,
                        "name" : "Torino"
                     },
                     "id" : 3175384,
                     "license" : {
                        "attribution" : "Data from geonames.org under a CC-BY 3.0 license",
                        "license" : "http://creativecommons.org/licenses/by/3.0/"
                     },
                     "nuts_level1" : {
                        "code" : "ITC",
                        "name" : "NORD-OVEST"
                     },
                     "nuts_level2" : {
                        "code" : "ITC1",
                        "name" : "Piemonte"
                     },
                     "nuts_level3" : {
                        "code" : "ITC11",
                        "name" : "Torino"
                     }
                  },
                  "lat" : 45.463181,
                  "line" : null,
                  "lng" : 7.874139,
                  "postcode" : null,
                  "primary" : false,
                  "state" : null,
                  "state_code" : null
               }
            ],
            "aliases" : [
               "ARTTIC Italy"
            ],
            "country" : {
               "country_code" : "IT",
               "country_name" : "Italy"
            },
            "email_address" : null,
            "established" : 1996,
            "external_ids" : {
               "GRID" : {
                  "all" : "grid.436349.f",
                  "preferred" : "grid.436349.f"
               }
            },
            "id" : "https://ror.org/01pp7vs05",
            "ip_addresses" : [],
            "labels" : [],
            "links" : [
               "http://www.nexture.it/eng/home.htm"
            ],
            "name" : "Nexture Consulting",
            "relationships" : [],
            "status" : "active",
            "types" : [
               "Company"
            ],
            "wikipedia_url" : ""
         },
         "score" : 0.43,
         "substring" : "Pisa 56126 Italy"
      },
      {
         "chosen" : false,
         "matching_type" : "COMMON TERMS",
         "organization" : {
            "acronyms" : [],
            "addresses" : [
               {
                  "city" : "Mantova",
                  "country_geonames_id" : 3175395,
                  "geonames_city" : {
                     "city" : "Mantova",
                     "geonames_admin1" : {
                        "ascii_name" : "Lombardy",
                        "code" : "IT.09",
                        "id" : 3174618,
                        "name" : "Lombardy"
                     },
                     "geonames_admin2" : {
                        "ascii_name" : "Provincia di Mantova",
                        "code" : "IT.09.MN",
                        "id" : 3174050,
                        "name" : "Provincia di Mantova"
                     },
                     "id" : 3174051,
                     "license" : {
                        "attribution" : "Data from geonames.org under a CC-BY 3.0 license",
                        "license" : "http://creativecommons.org/licenses/by/3.0/"
                     },
                     "nuts_level1" : {
                        "code" : "ITC",
                        "name" : "NORD-OVEST"
                     },
                     "nuts_level2" : {
                        "code" : "ITC4",
                        "name" : "Lombardia"
                     },
                     "nuts_level3" : {
                        "code" : "ITC4B",
                        "name" : "Mantova"
                     }
                  },
                  "lat" : 45.154438,
                  "line" : null,
                  "lng" : 10.783771,
                  "postcode" : null,
                  "primary" : false,
                  "state" : null,
                  "state_code" : null
               }
            ],
            "aliases" : [],
            "country" : {
               "country_code" : "IT",
               "country_name" : "Italy"
            },
            "email_address" : null,
            "established" : 1834,
            "external_ids" : {
               "GRID" : {
                  "all" : "grid.466074.7",
                  "preferred" : "grid.466074.7"
               }
            },
            "id" : "https://ror.org/03ax4bc53",
            "ip_addresses" : [],
            "labels" : [
               {
                  "iso639" : "it",
                  "label" : "Conservatorio di Musica \"Lucio Campiani\""
               }
            ],
            "links" : [
               "http://www.conservatoriomantova.com/en/?jjj=1459937953544"
            ],
            "name" : "Music Conservatory of Mantova",
            "relationships" : [],
            "status" : "active",
            "types" : [
               "Education"
            ],
            "wikipedia_url" : ""
         },
         "score" : 0.42,
         "substring" : "Largo Lucio Lazzarino 2 Pisa 56126"
      },
      {
         "chosen" : false,
         "matching_type" : "COMMON TERMS",
         "organization" : {
            "acronyms" : [],
            "addresses" : [
               {
                  "city" : "Pisa",
                  "country_geonames_id" : 3175395,
                  "geonames_city" : {
                     "city" : "Pisa",
                     "geonames_admin1" : {
                        "ascii_name" : "Tuscany",
                        "code" : "IT.16",
                        "id" : 3165361,
                        "name" : "Tuscany"
                     },
                     "geonames_admin2" : {
                        "ascii_name" : "Province of Pisa",
                        "code" : "IT.16.PI",
                        "id" : 3170646,
                        "name" : "Province of Pisa"
                     },
                     "id" : 3170647,
                     "license" : {
                        "attribution" : "Data from geonames.org under a CC-BY 3.0 license",
                        "license" : "http://creativecommons.org/licenses/by/3.0/"
                     },
                     "nuts_level1" : {
                        "code" : "ITI",
                        "name" : "CENTRO (IT)"
                     },
                     "nuts_level2" : {
                        "code" : "ITI1",
                        "name" : "Toscana"
                     },
                     "nuts_level3" : {
                        "code" : "ITI17",
                        "name" : "Pisa"
                     }
                  },
                  "lat" : 43.715772,
                  "line" : null,
                  "lng" : 10.399627,
                  "postcode" : null,
                  "primary" : false,
                  "state" : null,
                  "state_code" : null
               }
            ],
            "aliases" : [
               "Fondazione Cassa di Risparmio di Pisa"
            ],
            "country" : {
               "country_code" : "IT",
               "country_name" : "Italy"
            },
            "email_address" : null,
            "established" : 1992,
            "external_ids" : {
               "FundRef" : {
                  "all" : [
                     "100007362",
                     "100007368"
                  ],
                  "preferred" : null
               },
               "GRID" : {
                  "all" : "grid.479041.f",
                  "preferred" : "grid.479041.f"
               },
               "ISNI" : {
                  "all" : [
                     "0000 0000 9587 6793"
                  ],
                  "preferred" : null
               }
            },
            "id" : "https://ror.org/05jhnab13",
            "ip_addresses" : [],
            "labels" : [],
            "links" : [
               "http://www.fondazionepisa.it/"
            ],
            "name" : "Fondazione Pisa",
            "relationships" : [],
            "status" : "active",
            "types" : [
               "Nonprofit"
            ],
            "wikipedia_url" : "https://en.wikipedia.org/wiki/Fondazione_Pisa"
         },
         "score" : 0.41,
         "substring" : "Largo Lucio Lazzarino 2 Pisa 56126"
      },
      {
         "chosen" : false,
         "matching_type" : "COMMON TERMS",
         "organization" : {
            "acronyms" : [],
            "addresses" : [
               {
                  "city" : "Pisa",
                  "country_geonames_id" : 3175395,
                  "geonames_city" : {
                     "city" : "Pisa",
                     "geonames_admin1" : {
                        "ascii_name" : "Tuscany",
                        "code" : "IT.16",
                        "id" : 3165361,
                        "name" : "Tuscany"
                     },
                     "geonames_admin2" : {
                        "ascii_name" : "Province of Pisa",
                        "code" : "IT.16.PI",
                        "id" : 3170646,
                        "name" : "Province of Pisa"
                     },
                     "id" : 3170647,
                     "license" : {
                        "attribution" : "Data from geonames.org under a CC-BY 3.0 license",
                        "license" : "http://creativecommons.org/licenses/by/3.0/"
                     },
                     "nuts_level1" : {
                        "code" : "ITI",
                        "name" : "CENTRO (IT)"
                     },
                     "nuts_level2" : {
                        "code" : "ITI1",
                        "name" : "Toscana"
                     },
                     "nuts_level3" : {
                        "code" : "ITI17",
                        "name" : "Pisa"
                     }
                  },
                  "lat" : 43.721529,
                  "line" : null,
                  "lng" : 10.40824,
                  "postcode" : null,
                  "primary" : false,
                  "state" : null,
                  "state_code" : null
               }
            ],
            "aliases" : [
               "Istituto Nazionale di Fisica Nucleare Sezione di Pisa"
            ],
            "country" : {
               "country_code" : "IT",
               "country_name" : "Italy"
            },
            "email_address" : null,
            "established" : null,
            "external_ids" : {
               "GRID" : {
                  "all" : "grid.470216.6",
                  "preferred" : "grid.470216.6"
               }
            },
            "id" : "https://ror.org/05symbg58",
            "ip_addresses" : [],
            "labels" : [],
            "links" : [
               "http://www.pi.infn.it/"
            ],
            "name" : "INFN Sezione di Pisa",
            "relationships" : [
               {
                  "id" : "https://ror.org/005ta0471",
                  "label" : "National Institute for Nuclear Physics",
                  "type" : "Parent"
               }
            ],
            "status" : "active",
            "types" : [
               "Facility"
            ],
            "wikipedia_url" : ""
         },
         "score" : 0.39,
         "substring" : "Pisa 56126 Italy"
      },
      {
         "chosen" : false,
         "matching_type" : "COMMON TERMS",
         "organization" : {
            "acronyms" : [
               "WHO"
            ],
            "addresses" : [
               {
                  "city" : "Rome",
                  "country_geonames_id" : 3175395,
                  "geonames_city" : {
                     "city" : "Rome",
                     "geonames_admin1" : {
                        "ascii_name" : "Latium",
                        "code" : "IT.07",
                        "id" : 3174976,
                        "name" : "Latium"
                     },
                     "geonames_admin2" : {
                        "ascii_name" : "Citta metropolitana di Roma Capitale",
                        "code" : "IT.07.RM",
                        "id" : 3169069,
                        "name" : "Città metropolitana di Roma Capitale"
                     },
                     "id" : 3169070,
                     "license" : {
                        "attribution" : "Data from geonames.org under a CC-BY 3.0 license",
                        "license" : "http://creativecommons.org/licenses/by/3.0/"
                     },
                     "nuts_level1" : {
                        "code" : "ITI",
                        "name" : "CENTRO (IT)"
                     },
                     "nuts_level2" : {
                        "code" : "ITI4",
                        "name" : "Lazio"
                     },
                     "nuts_level3" : {
                        "code" : "ITI43",
                        "name" : "Roma"
                     }
                  },
                  "lat" : 41.901298,
                  "line" : null,
                  "lng" : 12.489296,
                  "postcode" : null,
                  "primary" : false,
                  "state" : null,
                  "state_code" : null
               }
            ],
            "aliases" : [
               "WHO Italy"
            ],
            "country" : {
               "country_code" : "IT",
               "country_name" : "Italy"
            },
            "email_address" : null,
            "established" : 1948,
            "external_ids" : {
               "GRID" : {
                  "all" : "grid.426427.1",
                  "preferred" : "grid.426427.1"
               },
               "ISNI" : {
                  "all" : [
                     "0000 0004 6040 4752"
                  ],
                  "preferred" : null
               },
               "Wikidata" : {
                  "all" : [
                     "Q30285506"
                  ],
                  "preferred" : null
               }
            },
            "id" : "https://ror.org/0558jee48",
            "ip_addresses" : [],
            "labels" : [],
            "links" : [
               "http://www.who.int/countries/ita/en/"
            ],
            "name" : "World Health Organization - Italy",
            "relationships" : [
               {
                  "id" : "https://ror.org/01rz37c55",
                  "label" : "World Health Organization Regional Office for Europe",
                  "type" : "Parent"
               }
            ],
            "status" : "active",
            "types" : [
               "Government"
            ],
            "wikipedia_url" : "https://en.wikipedia.org/wiki/World_Health_Organization"
         },
         "score" : 0.38,
         "substring" : "Pisa 56126 Italy"
      },
      {
         "chosen" : false,
         "matching_type" : "COMMON TERMS",
         "organization" : {
            "acronyms" : [],
            "addresses" : [
               {
                  "city" : "Pisa",
                  "country_geonames_id" : 3175395,
                  "geonames_city" : {
                     "city" : "Pisa",
                     "geonames_admin1" : {
                        "ascii_name" : "Tuscany",
                        "code" : "IT.16",
                        "id" : 3165361,
                        "name" : "Tuscany"
                     },
                     "geonames_admin2" : {
                        "ascii_name" : "Province of Pisa",
                        "code" : "IT.16.PI",
                        "id" : 3170646,
                        "name" : "Province of Pisa"
                     },
                     "id" : 3170647,
                     "license" : {
                        "attribution" : "Data from geonames.org under a CC-BY 3.0 license",
                        "license" : "http://creativecommons.org/licenses/by/3.0/"
                     },
                     "nuts_level1" : {
                        "code" : "ITI",
                        "name" : "CENTRO (IT)"
                     },
                     "nuts_level2" : {
                        "code" : "ITI1",
                        "name" : "Toscana"
                     },
                     "nuts_level3" : {
                        "code" : "ITI17",
                        "name" : "Pisa"
                     }
                  },
                  "lat" : 43.719826,
                  "line" : null,
                  "lng" : 10.400298,
                  "postcode" : null,
                  "primary" : false,
                  "state" : "Toscana",
                  "state_code" : "IT-52"
               }
            ],
            "aliases" : [],
            "country" : {
               "country_code" : "IT",
               "country_name" : "Italy"
            },
            "email_address" : null,
            "established" : 1810,
            "external_ids" : {
               "FundRef" : {
                  "all" : [
                     "100009093"
                  ],
                  "preferred" : null
               },
               "GRID" : {
                  "all" : "grid.6093.c",
                  "preferred" : "grid.6093.c"
               },
               "OrgRef" : {
                  "all" : [
                     "1217460"
                  ],
                  "preferred" : null
               },
               "Wikidata" : {
                  "all" : [
                     "Q672416"
                  ],
                  "preferred" : null
               }
            },
            "id" : "https://ror.org/03aydme10",
            "ip_addresses" : [],
            "labels" : [
               {
                  "iso639" : "fr",
                  "label" : "École Normale Supérieure de Pise"
               }
            ],
            "links" : [
               "http://www.sns.it/en/"
            ],
            "name" : "Scuola Normale Superiore di Pisa",
            "relationships" : [
               {
                  "id" : "https://ror.org/01sgfhb12",
                  "label" : "National Enterprise for NanoScience and NanoTechnology",
                  "type" : "Child"
               }
            ],
            "status" : "active",
            "types" : [
               "Other"
            ],
            "wikipedia_url" : "http://en.wikipedia.org/wiki/Scuola_Normale_Superiore_di_Pisa"
         },
         "score" : 0.33,
         "substring" : "Pisa 56126 Italy"
      },
      {
         "chosen" : false,
         "matching_type" : "COMMON TERMS",
         "organization" : {
            "acronyms" : [
               "MSD"
            ],
            "addresses" : [
               {
                  "city" : "Rome",
                  "country_geonames_id" : 3175395,
                  "geonames_city" : {
                     "city" : "Rome",
                     "geonames_admin1" : {
                        "ascii_name" : "Latium",
                        "code" : "IT.07",
                        "id" : 3174976,
                        "name" : "Latium"
                     },
                     "geonames_admin2" : {
                        "ascii_name" : "Citta metropolitana di Roma Capitale",
                        "code" : "IT.07.RM",
                        "id" : 3169069,
                        "name" : "Città metropolitana di Roma Capitale"
                     },
                     "id" : 3169070,
                     "license" : {
                        "attribution" : "Data from geonames.org under a CC-BY 3.0 license",
                        "license" : "http://creativecommons.org/licenses/by/3.0/"
                     },
                     "nuts_level1" : {
                        "code" : "ITI",
                        "name" : "CENTRO (IT)"
                     },
                     "nuts_level2" : {
                        "code" : "ITI4",
                        "name" : "Lazio"
                     },
                     "nuts_level3" : {
                        "code" : "ITI43",
                        "name" : "Roma"
                     }
                  },
                  "lat" : 41.889248,
                  "line" : null,
                  "lng" : 12.522404,
                  "postcode" : null,
                  "primary" : false,
                  "state" : null,
                  "state_code" : null
               }
            ],
            "aliases" : [
               "Merck Sharp & Dohme"
            ],
            "country" : {
               "country_code" : "IT",
               "country_name" : "Italy"
            },
            "email_address" : null,
            "established" : 1891,
            "external_ids" : {
               "GRID" : {
                  "all" : "grid.419499.8",
                  "preferred" : "grid.419499.8"
               },
               "Wikidata" : {
                  "all" : [
                     "Q30282150"
                  ],
                  "preferred" : null
               }
            },
            "id" : "https://ror.org/01mgtm102",
            "ip_addresses" : [],
            "labels" : [],
            "links" : [
               "http://www.msd-italia.it/"
            ],
            "name" : "MSD (Italy)",
            "relationships" : [
               {
                  "id" : "https://ror.org/02891sr49",
                  "label" : "MSD (United States)",
                  "type" : "Parent"
               }
            ],
            "status" : "active",
            "types" : [
               "Company"
            ],
            "wikipedia_url" : "https://en.wikipedia.org/wiki/Merck_%26_Co."
         },
         "score" : 0.22,
         "substring" : "Pisa 56126 Italy"
      }
   ],
   "number_of_results" : 13
}

🚧

No paging or filtering for affiliation searches

The affiliation parameter does not need paging and does not accept filters. When filter syntax is added to the end of an affiliation search, the terms will be treated as part of the affiliation search. All results will be returned, not just the first 20.

Advanced search

📘

Complete API advanced search guide

See our API advanced search guide for complete documentation and examples.

Allows searching all ROR record fields. Complex queries using field names, wildcards, boolean operators, etc can be constructed using Elastic Search query string syntax. Uses the format https://api.ror.org/organizations?query.advanced=<field name>:<search term>. Advanced searches return the first 20 results and can be filtered.

The value of the query parameter must be URL-encoded and Elasticsearch reserved characters such as &, (), / and : must be URL-encoded and escaped using a URL-encoded \ character. See Special characters below for more details.

curl 'https://api.ror.org/organizations?query.advanced=name:Harvard%20University'

Paging

The ROR API returns a maximum of 20 results per page for query and advanced query searches, beginning at page 1. If metadata.number_of_results is greater than 20, retrieve subsequent records using the format https://api.ror.org/organizations?page=<page number>

❗️

Pagination limited to 500 pages

Elastic Search has an inherent upper limit of 10,000 results, which means that it is currently not possible to retrieve pages beyond page 500. If you need to use the entire ROR dataset in your application, please download the data dump If you send a request for a page beyond 500, you will receive a 200 status, but an error response like {"errors":["page '5144' outside of range 1-500”]}

curl https://api.ror.org/organizations?page=2

To determine how many pages you will need to retrieve in order to obtain your entire result set, check metadata.number_of_results and divide by 20. Regardless of which page you are on, metadata.number_of_results indicates the total number of results returned by your request or query.

🚧

No paging with affiliation searching

Affiliation searches return all results, not just the first 20, so results do not need to be paged.

Filtering

ROR API results for query and advanced query searches can be filtered by organization type, country code, or country name using the filter parameter with types, country.country_code, or country.country_name.

Uses the format https://api.ror.org/organizations?filter=<filter>:<value>.

Country codes are those in the ISO 3166 alpha-2 list.

Available organization types:

  • Education
  • Healthcare
  • Company
  • Archive
  • Nonprofit
  • Government
  • Facility
  • Other
curl https://api.ror.org/organizations?filter=types:Facility

curl https://api.ror.org/organizations?filter=types:Facility

curl https://api.ror.org/organizations?filter=country.country_code:GB

curl https://api.ror.org/organizations?filter=country.country_name:France

You can combine multiple filters in a single request.

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

You can add filters to query parameter searches.

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

You can add filters to advanced query parameter searches.

curl https://api.ror.org/organizations?query.advanced=name:Harvard%20University&filter=types:Education

🚧

No filtering with affiliation searching

The affiliation parameter does not accept filters. When filter syntax is added to the end of an affiliation search, the terms will be treated as part of the affiliation search.

Special characters

Some organization names contain characters like &, (), : and /, which have special meaning in URI syntax, Elasticsearch syntax or both. To avoid error responses or special characters being interpreted as part of a complex Elasticsearch query:

Example queries for organization names with special characters:

Harvard University/MGH

curl https://api.ror.org/organizations?query=Harvard%20University%5C%2FMGH

Franklin & Marshall College

curl https://api.ror.org/organizations?query=Franklin%20%26%20Marshall%20College

Rolls-Royce (United Kingdom)

https://api.ror.org/organizations?query=Rolls%5C-Royce%20%5C%28United%20Kingdom%5C%29