{"openapi":"3.1.0","info":{"title":"Research Organizations API","version":"1.0.0","description":"Every research organization in the world as an API — powered by ROR, the Research Organization Registry. ROR assigns a persistent open identifier (a ROR ID) to universities, government labs, companies, nonprofits, hospitals, archives and research facilities, with rich, curated metadata and crosswalks to GRID, ISNI, Wikidata and the Crossref Funder Registry. Search the registry by name (and filter by country or organization type); resolve any ROR ID to its full record — names, acronyms and aliases, types, location (city, country, coordinates), website, domains, external identifiers and relationships to parent and child organizations; and match a messy free-text affiliation string (\"Dept. of Physics, Heidelberg University, Germany\") to the most likely organizations with a confidence score — perfect for cleaning and disambiguating author-affiliation data. It is a research-organization identifier registry, distinct from a plain university directory, and a natural companion to ORCID (for people) in any scholarly-metadata stack. Open data from ROR (CC0).","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/ror-api","description":"oanor gateway"}],"tags":[{"name":"Organizations"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/affiliation":{"get":{"operationId":"get_v1_affiliation","tags":["Organizations"],"summary":"Match an affiliation string to organizations","description":"","parameters":[{"name":"q","in":"query","required":false,"description":"A free-text affiliation string","schema":{"type":"string"},"example":"Heidelberg University"},{"name":"limit","in":"query","required":false,"description":"Max matches (1-50, default 10)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":10,"matches":[{"name":"Heidelberg University","score":1,"types":["education"],"chosen":false,"ror_id":"04rcqnp59","status":"active","ror_url":"https://ror.org/04rcqnp59","location":{"lat":41.1145,"lng":-83.17797,"city":"Tiffin","country":"United States","country_code":"US"},"substring":"Heidelberg University","established":1850,"matching_type":"SINGLE SEARCH"},{"name":"Heidelberg University","score":1,"types":["education","funder"],"chosen":false,"ror_id":"038t36y30","status":"active","ror_url":"https://ror.org/038t36y30","location":{"lat":49.40768,"lng":8.69079,"city":"Heidelberg","country":"Germany","country_code":"DE"},"substring":"Heidelberg University","established":1386,"matching_type":"SINGLE SEARCH"},{"name":"Godfrey Okoye University","score":0.96,"types":["education"],"chosen":false,"ror_id":"04japw488","status":"active","ror_url":"https://ror.org/04japw488","location":{"lat":6.44132,"lng":7.49883,"city":"Enugu","country":"Nigeria","country_code":"NG"},"substring":"Heidelberg University","established":2009,"matching_type":"SINGLE SEARCH"},{"name":"Hong Kong Virtual University","score":0.9,"types":["education"],"chosen":false,"ror_id":"023mp3m37","status":"active","ror_url":"https://ror.org/023mp3m37","location":{"lat":22.27832,"lng":114.17469,"city":"Hong Kong","country":"Hong Kong","country_code":"HK"},"substring":"Heidelberg University","established":2001,"matching_type":"SINGLE SEARCH"},{"name":"Cyber University","score":0.9,"types":["education"],"chosen":false,"ror_id":"038sdcw17","status":"active","ror_url":"https://ror.org/038sdcw17","location":{"lat":33.6,"lng":130.41667,"city":"Fukuoka","country":"Japan","country_code":"JP"},"substring":"Heidelberg University","established":2007,"matching_type":"SINGLE SEARCH"},{"name":"EuroAcademy","score":0.9,"types":["education"],"chosen":false,"ror_id":"02hb34304","status":"active","ror_url":"https://ror.org/02hb34304","location":{"lat":59.43696,"lng":24.75353,"city":"Tallinn","country":"Estonia","country_code":"EE"},"substring":"Heidelberg University","established":1997,"matching_type":"SINGLE SEARCH"},{"name":"Air University","score":0.89,"types":["education"],"chosen":false,"ror_id":"03yfe9v83","status":"active","ror_url":"https://ror.org/03yfe9v83","location":{"lat":33.72148,"lng":73.04329,"city":"Islamabad","country":"Pakistan","country_code":"PK"},"substring":"Heidelberg University","established":2002,"matching_type":"SINGLE SEARCH"},{"name":"Shahid Sattari University of Aeronautical Engineering","score":0.89,"types":["education"],"chosen":false,"ror_id":"00kp9ef37","status":"active","ror_url":"https://ror.org/00kp9ef37","location":{"lat":35.69439,"lng":51.42151,"city":"Tehran","country":"Iran","country_code":"IR"},"substring":"Heidelberg University","established":1988,"matching_type":"SINGLE SEARCH"},{"name":"Hue University of Education","score":0.88,"types":["education"],"chosen":false,"ror_id":"04bm3wy68","status":"active","ror_url":"https://ror.org/04bm3wy68","location":{"lat":16.4619,"lng":107.59546,"city":"Huế","country":"Vietnam","country_code":"VN"},"substring":"Heidelberg University","established":1957,"matching_type":"SINGLE SEARCH"},{"name":"Ibb University","score":0.88,"types":["education"],"chosen":false,"ror_id":"00fhcxc56","status":"active","ror_url":"https://ror.org/00fhcxc56","location":{"lat":13.96667,"lng":44.18333,"city":"Ibb","country":"Yemen","country_code":"YE"},"substring":"Heidelberg University","established":1996,"matching_type":"SINGLE SEARCH"}],"affiliation":"Heidelberg University"},"meta":{"timestamp":"2026-06-01T16:23:03.522Z","request_id":"94f2b356-9e8f-4a8b-b642-7c408d801bc0"},"status":"ok","message":"Affiliation matched","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/org":{"get":{"operationId":"get_v1_org","tags":["Organizations"],"summary":"A single organization by ROR id","description":"","parameters":[{"name":"id","in":"query","required":false,"description":"A ROR id (from /v1/search)","schema":{"type":"string"},"example":"04rcqnp59"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"organization":{"name":"Heidelberg University","types":["education"],"ror_id":"04rcqnp59","status":"active","aliases":["Heidelberg College"],"domains":[],"ror_url":"https://ror.org/04rcqnp59","website":"http://www.heidelberg.edu/","acronyms":[],"location":{"lat":41.1145,"lng":-83.17797,"city":"Tiffin","country":"United States","country_code":"US"},"wikipedia":"https://en.wikipedia.org/wiki/Heidelberg_University_(Ohio)","established":1850,"external_ids":{"grid":"grid.420674.3","isni":"0000 0001 0696 6322","wikidata":"Q5698693"},"relationships":[]}},"meta":{"timestamp":"2026-06-01T16:23:03.658Z","request_id":"f04847d4-50bb-4787-a1e3-44780b34ffea"},"status":"ok","message":"Organization retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Organizations"],"summary":"Search research organizations","description":"","parameters":[{"name":"q","in":"query","required":false,"description":"Name to search","schema":{"type":"string"},"example":"Heidelberg University"},{"name":"country","in":"query","required":false,"description":"2-letter country filter","schema":{"type":"string"}},{"name":"type","in":"query","required":false,"description":"Type filter (education, government, company, …)","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max results (1-100, default 20)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":20,"query":"Heidelberg University","total":13102,"organizations":[{"name":"Heidelberg University","types":["education"],"ror_id":"04rcqnp59","status":"active","ror_url":"https://ror.org/04rcqnp59","location":{"lat":41.1145,"lng":-83.17797,"city":"Tiffin","country":"United States","country_code":"US"},"established":1850},{"name":"Heidelberg University","types":["education","funder"],"ror_id":"038t36y30","status":"active","ror_url":"https://ror.org/038t36y30","location":{"lat":49.40768,"lng":8.69079,"city":"Heidelberg","country":"Germany","country_code":"DE"},"established":1386},{"name":"University Hospital Heidelberg","types":["funder","healthcare"],"ror_id":"013czdx64","status":"active","ror_url":"https://ror.org/013czdx64","location":{"lat":49.40768,"lng":8.69079,"city":"Heidelberg","country":"Germany","country_code":"DE"},"established":1388},{"name":"Heidelberg University of Education","types":["education"],"ror_id":"0044w3h23","status":"active","ror_url":"https://ror.org/0044w3h23","location":{"lat":49.40768,"lng":8.69079,"city":"Heidelberg","country":"Germany","country_code":"DE"},"established":1962},{"name":"European Molecular Biology Laboratory","types":["government"],"ror_id":"03mstc592","status":"active","ror_url":"https://ror.org/03mstc592","location":{"lat":49.40768,"lng":8.69079,"city":"Heidelberg","country":"Germany","country_code":"DE"},"established":1974},{"name":"Diabetesinstitut Heidelberg","types":["facility"],"ror_id":"03egr7630","status":"active","ror_url":"https://ror.org/03egr7630","location":{"lat":49.40768,"lng":8.69079,"city":"Heidelberg","country":"Germany","country_code":"DE"},"established":2009},{"name":"Nierenzentrum Heidelberg","types":["healthcare"],"ror_id":"01nwbp351","status":"active","ror_url":"https://ror.org/01nwbp351","location":{"lat":49.40768,"lng":8.69079,"city":"Heidelberg","country":"Germany","country_code":"DE"},"established":2003},{"name":"Augenklinik Heidelberg","types":["healthcare"],"ror_id":"005j0cx32","status":"active","ror_url":"https://ror.org/005j0cx32","location":{"lat":49.40768,"lng":8.69079,"city":"Heidelberg","country":"Germany","country_code":"DE"}},{"name":"Frauenklinik Heidelberg","types":["healthcare"],"ror_id":"02js38076","status":"active","ror_url":"https://ror.org/02js38076","location":{"lat":49.40768,"lng":8.69079,"city":"Heidelberg","country":"Germany","country_code":"DE"}},{"name":"Hautklinik Heidelberg","types":["healthcare"],"ror_id":"023m9rp24","status":"active","ror_url":"https://ror.org/023m9rp24","location":{"lat":49.40768,"lng":8.69079,"city":"Heidelberg","country":"Germany","country_code":"DE"}},{"name":"National Center for Tumor Diseases","types":["funder","healthcare"],"ror_id":"01txwsw02","status":"active","ror_url":"https://ror.org/01txwsw02","location":{"lat":49.40768,"lng":8.69079,"city":"Heidelberg","country":"Germany","country_code":"DE"},"established":2010},{"name":"Heidelberg (Poland)","types":["company"],"ror_id":"05xcp0f40","status":"active","ror_url":"https://ror.org/05xcp0f40","location":{"lat":52.22977,"lng":21.01178,"city":"Warsaw","country":"Poland","country_code":"PL"},"established":1996},{"name":"Wasserstraßen-Neubauamt Heidelberg","types":["government"],"ror_id":"05xfjq530","status":"active","ror_url":"https://ror.org/05xfjq530","location":{"lat":52.2279,"lng":11.00985,"city":"Helmstedt","country":"Germany","country_code":"DE"},"established":2007},{"name":"Medizinische Fakultät Mannheim","types":["education"],"ror_id":"02m1z0a87","status":"active","ror_url":"https://ror.org/02m1z0a87","location":{"lat":49.4891,"lng":8.46694,"city":"Mannheim","country":"Germany","country_code":"DE"},"established":1600},{"name":"Hochschule Fresenius Heidelberg","types":["education"],"ror_id":"00zk46w34","status":"active","ror_url":"https://ror.org/00zk46w34","location":{"lat":49.40768,"lng":8.69079,"city":"Heidelberg","country":"Germany","country_code":"DE"},"established":2011},{"name":"Heidelberg Repatriation Hospital","types":["healthcare"],"ror_id":"04dhg0348","status":"active","ror_url":"https://ror.org/04dhg0348","location":{"lat":-37.814,"lng":144.96332,"city":"Melbourne","country":"Australia","country_code":"AU"},"established":1941},{"name":"Chirurgische Universitätsklinik Heidelberg","types":["healthcare"],"ror_id":"05fe3fx56","status":"active","ror_url":"https://ror.org/05fe3fx56","location":{"lat":49.40768,"lng":8.69079,"city":"Heidelberg","country":"Germany","country_code":"DE"},"established":1818},{"name":"SRH Hochschule Heidelberg","types":["education"],"ror_id":"00g07sz63","status":"active","ror_url":"https://ror.org/00g07sz63","location":{"lat":49.40768,"lng":8.69079,"city":"Heidelberg","country":"Germany","country_code":"DE"}},{"name":"Heidelberg Pharma (Germany)","types":["company"],"ror_id":"036sabf92","status":"active","ror_url":"https://ror.org/036sabf92","location":{"lat":49.47307,"lng":8.60896,"city":"Ladenburg","country":"Germany","country_code":"DE"},"established":1997},{"name":"Heidelberg Engineering (Germany)","types":["company","funder"],"ror_id":"03thsxs59","status":"active","ror_url":"https://ror.org/03thsxs59","location":{"lat":49.40768,"lng":8.69079,"city":"Heidelberg","country":"Germany","country_code":"DE"},"established":1990}]},"meta":{"timestamp":"2026-06-01T16:23:04.226Z","request_id":"a8605266-46ab-4e7d-af09-d2bd00d74cc4"},"status":"ok","message":"Organizations retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Endpoint catalogue & notes","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"ROR (the Research Organization Registry) gives every research-performing organization in the world a persistent open identifier (a ROR ID) — universities, government labs, companies, nonprofits, hospitals, archives and facilities — with rich metadata and crosswalks to GRID, ISNI, Wikidata and the Crossref Funder Registry. /v1/search?q=Heidelberg University = search the registry (optionally filter by country=DE or type=education/government/company/nonprofit/healthcare/facility/archive/funder/other), returning each org's ROR id, display name, types, established year and location; /v1/org?id=04rcqnp59 = a single organization's full record — names, acronyms and aliases, types, location (city, country, coordinates), website, domains, external ids (GRID/ISNI/Wikidata/Fundref) and relationships to parent/child organizations; /v1/affiliation?q=Department of Physics, Heidelberg University, Germany = match a free-text affiliation string to the most likely organizations, with a confidence score and a 'chosen' flag (ideal for cleaning author-affiliation data). ROR ids look like 04rcqnp59 (you may pass the full https://ror.org/ URL). Data from ROR (CC0). A research-organization identifier registry — distinct from a plain university directory. Ideal for scholarly metadata, author-affiliation disambiguation, CRIS/repository and research-analytics tools.","source":"ROR — Research Organization Registry, v2 (ror.org)","endpoints":["/v1/search","/v1/org","/v1/affiliation","/v1/meta"]},"meta":{"timestamp":"2026-06-01T16:23:04.315Z","request_id":"a5459f02-a5fe-4c52-a12a-4e2c37251292"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":3000,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":780,"monthly_call_quota":60000,"rps_limit":8,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2450,"monthly_call_quota":280000,"rps_limit":20,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":6400,"monthly_call_quota":980000,"rps_limit":50,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/ror-api"}