ROR

ROR Support

You’ll find technical docs about ROR tools and services and implementation guides with tips for using these tools/services to address specific use cases, as well as support contacts to help if you get stuck. Let's ROR!

Get Started    

The ROR API allows to retrieve, search and filter the organizations indexed in ROR. The results are returned in JSON.

📘

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 all organization records in ROR

Retrieve all organization records in ROR, along with metadata including the total number of records and aggregated counts by country and type.

📘

Paging & filtering

This request retrieves only the first 20 records. See Paging below for information about how to retrieve additional results. This request can also be filtered by organization location and type. See Filtering below.

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 2 ways to search ROR records:

  • Query parameter: Searches all indexed fields in ROR records. Works best for searching based on a small number of key terms or finding exact matchings for a particular string (using quotes).

  • Affiliation parameter: Performs multiple searches of the name, alias and label fields using different search algorithms and returns the best match(es) based on matching score. Returns better results than query parameter search for long/complicated text strings (such as full affiliation names).

Query parameter

Search all indexed fields in ROR records using the format https://api.ror.org/organizations?query=<search term>

📘

Paging & filtering

This request retrieves only the first 20 records. See Paging below for information about how to retrieve additional results. This request can also be filtered by organization location and type. See Filtering below.

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
}

Affiliation parameter

Search name, alias and label fields using different search algorithms and returns the best match(es) based on matching score using the format https://api.ror.org/organizations?affiliation=<URL-encoded string>

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

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 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

📘

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
}

Paging

The ROR API returns a maximum of 20 results per page, 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>

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.

Filtering

ROR API results can be filtered by type, country code or country name using the filter parameter.

  • Available types are Education, Healthcare, Company, Archive, Nonprofit, Government, Facility, and Other
  • Country codes are those in the ISO 3166 alpha-2 list
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 also combine filters with querying

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

Updated 2 days ago

REST API


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.