Match organization names to ROR IDs

<!DOCTYPE html><html lang="en" style="" data-color-mode="light" class=" useReactApp "><head><script src="https://cdn.readme.io/public/js/force-firefox-anchor-jump.js?1739547471672"></script><meta charset="utf-8"><meta http-equiv="X-UA-Compatible" content="IE=edge"><meta name="readme-deploy" content="5.281.0"><meta name="readme-subdomain" content="ror"><meta name="readme-version" content="1"><title>Match organization names to ROR IDs</title><meta name="description" content="This document provides guidance on matching organization names to ROR IDs using the ROR API, including different approaches like the affiliation parameter and query parameter methods. It also mentions using scripts, the ROR data dump, OpenRefine, and third-party tools for this purpose."><meta property="og:title" content="Match organization names to ROR IDs"><meta property="og:description" content="This document provides guidance on matching organization names to ROR IDs using the ROR API, including different approaches like the affiliation parameter and query parameter methods. It also mentions using scripts, the ROR data dump, OpenRefine, and third-party tools for this purpose."><meta property="og:site_name" content="ROR"><meta name="twitter:title" content="Match organization names to ROR IDs"><meta name="twitter:description" content="This document provides guidance on matching organization names to ROR IDs using the ROR API, including different approaches like the affiliation parameter and query parameter methods. It also mentions using scripts, the ROR data dump, OpenRefine, and third-party tools for this purpose."><meta name="twitter:card" content="summary_large_image"><meta name="viewport" content="width=device-width, initial-scale=1.0"><meta property="og:image" content="https://files.readme.io/4680beec6938bde00138451225326037ace6f6e8011c88b92e902c051dfb922e-small-ror-logo-2600px.png"><meta name="twitter:image" content="https://files.readme.io/4680beec6938bde00138451225326037ace6f6e8011c88b92e902c051dfb922e-small-ror-logo-2600px.png"><link id="favicon" rel="shortcut icon" href="https://files.readme.io/a931430-small-ror-icon-profile_2.png" type="image/png"><link rel="canonical" href="https://ror.readme.io/docs/matching"><script src="https://cdn.readme.io/public/js/cash-dom.min.js?1739547471672"></script><link data-chunk="routes-Dash-ChatGPT-CopilotInstalledPage" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/routes-Dash-ChatGPT-CopilotInstalledPage.e465d3c8429ef097e6ed.css"> <link data-chunk="New" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/New.14c9c3c968352dbbe7dd.css"> <link data-chunk="Editor" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/Editor.bdadb1e8cc8aa84d5e86.css"> <link data-chunk="routes-Changelog" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/routes-Changelog.28957affcff81e852361.css"> <link data-chunk="Page" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/Page.14c9c3c968352dbbe7dd.css"> <link data-chunk="routes-SuperHub-Routes" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/routes-SuperHub-Routes.0bad54c5a8928aaaf4c6.css"> <link data-chunk="List" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/List.0191c4b0bafb7ea55b1e.css"> <link data-chunk="routes-Discuss" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/routes-Discuss.571e99fd5e02a59c06dd.css"> <link data-chunk="routes-Tutorials" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/routes-Tutorials.c978ddef3555c7447f00.css"> <link data-chunk="CustomPage" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/CustomPage.38a39d6ce8b0e2afad5a.css"> <link data-chunk="routes-Landing" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/routes-Landing.332d7eed7b2d976c458e.css"> <link data-chunk="routes-Doc" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/routes-Doc.f7ce97dc8d07fa3e6aaa.css"> <link data-chunk="routes-PageNotFound" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/routes-PageNotFound.d8afd1171cf7a455eed7.css"> <link data-chunk="routes-Reference" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/routes-Reference.60a8dcec37a13b0b71c5.css"> <link data-chunk="Header" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/Header.862d4391741934767cc6.css"> <link data-chunk="routes-SuperHub" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/routes-SuperHub.18e10a8c3a8566f5cd89.css"> <link data-chunk="routes-SuperHub" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/777.75e3fc491ee8103c63a3.css"> <link data-chunk="routes-SuperHub" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/2395.593cd7b6ba0bdb6787a8.css"> <link data-chunk="main" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/main.ef84cc15c1ff3d327657.css"> <link data-chunk="main" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/ui-styles.1c9b1263c4b136f42e7c.css"> <link data-chunk="main" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/main.8f0f9842d9d694d25653.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/6601.cef2fa12a9b5e2b9df03.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/3622.30b9cb2443fabb238262.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/9772.ff8569d00b013c692975.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/4904.df63e6b74f3878787175.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/7449.dae0332305a8704415a6.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/7372.aa4569536a36087cf4a9.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/9082.f9fa9ec2b80af1ef61bd.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/734.2949e3d7010fa5c21ffd.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/954.3489f00e90e7627e0a4f.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/6903.75b9333e2c99d6924d0e.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/2395.2e57fd05aa65fe956c0d.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/6522.ccf876992083e861c716.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/6471.9b6a78348f451ad7179f.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/1095.b595bea4632cd7baf7d3.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/777.ef77d501263107e85d40.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/5753.cf11ea4f8d4c552b72f2.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/routes-SuperHub.9e8cc6b3b1eb13756c87.js"> <link data-chunk="Header" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/9930.8ac6b4156bf4ee8644e6.js"> <link data-chunk="Header" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/7783.fdde3006d3bddb71d71f.js"> <link data-chunk="Header" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/Header.f647f7f0ae63a468ff05.js"> <link data-chunk="core-icons-chevron-up-down-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-chevron-up-down-svg.6aae957df71e6f4c5e24.js"> <link data-chunk="routes-Reference" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/4287.916cdd386055d2c5d238.js"> <link data-chunk="routes-Reference" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/5948.a51402657e2eb40ab43b.js"> <link data-chunk="routes-Reference" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/4201.0dcb58fab6c4005e3490.js"> <link data-chunk="routes-Reference" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/8230.205a1750fac29d9c2b33.js"> <link data-chunk="routes-Reference" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/routes-Reference.56680627529013bc5655.js"> <link data-chunk="core-icons-more-vertical-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-more-vertical-svg.4822b3f831e11095980d.js"> <link data-chunk="Footer" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/Footer.8514b725f5cc2d3b093c.js"> <link data-chunk="routes-PageNotFound" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/routes-PageNotFound.a7fc6699ce547c746349.js"> <link data-chunk="routes-Doc" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/routes-Doc.77726690b2730b652fcc.js"> <link data-chunk="core-icons-arrow-up-right-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-arrow-up-right-svg.8ec73f7e322d79a2695b.js"> <link data-chunk="core-icons-lock-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-lock-svg.70942d3ee6bad6267696.js"> <link data-chunk="routes-Landing" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/4002.704e628347d37011965d.js"> <link data-chunk="routes-Landing" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/1525.14392173bbb8515a4952.js"> <link data-chunk="routes-Landing" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/routes-Landing.b95f6aef50c6c4b838ab.js"> <link data-chunk="CustomPage" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/6922.e8247ef6931a72e55b3e.js"> <link data-chunk="CustomPage" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/CustomPage.dc3b5b02d7c889ec94bf.js"> <link data-chunk="routes-Tutorials" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/routes-Tutorials.13fce08dd6ce7450aa5c.js"> <link data-chunk="routes-Discuss" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/routes-Discuss.767eaf4d840eff595fe5.js"> <link data-chunk="List" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/2637.f161cf21b4202fcf0f18.js"> <link data-chunk="List" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/4674.95030b896e483d287f2e.js"> <link data-chunk="List" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/List.c3e7d6a183b1f2ad779c.js"> <link data-chunk="core-icons-star-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-star-svg.b834e1612cb2af1e174e.js"> <link data-chunk="core-icons-trending-up-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-trending-up-svg.0dd920b0698e57f75afa.js"> <link data-chunk="core-icons-callout-info-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-callout-info-svg.79b14e8568c9cecbc827.js"> <link data-chunk="core-icons-search-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-search-svg.ad9cac962958d30983a7.js"> <link data-chunk="core-icons-custom-pages-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-custom-pages-svg.444e514638d9afbec182.js"> <link data-chunk="routes-SuperHub-Routes" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/7285.703d773b1bb63ae6e7ee.js"> <link data-chunk="routes-SuperHub-Routes" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/routes-SuperHub-Routes.7f0f17c99d42871fe2fb.js"> <link data-chunk="core-icons-arrow-right-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-arrow-right-svg.eadb74658f93b4e7d75f.js"> <link data-chunk="RMDX" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/RMDX.69369bc391183526305f.js"> <link data-chunk="core-icons-alert-circle-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-alert-circle-svg.4cee8264c97045599b56.js"> <link data-chunk="Page" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/Page.91ab5df2f5275ac772af.js"> <link data-chunk="routes-Changelog" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/routes-Changelog.cbaec12bbdd9e5fad9a5.js"> <link data-chunk="Post" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/Post.922078b47615946064e5.js"> <link data-chunk="Editor" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/Editor.bfd7979c3ede22ebb6ef.js"> <link data-chunk="core-icons-x-circle-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-x-circle-svg.abc0e0ea5b7f9dff667c.js"> <link data-chunk="core-icons-suggested-edits-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-suggested-edits-svg.8d2d8ac2fd22ded9238d.js"> <link data-chunk="core-icons-webhook-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-webhook-svg.fe540ea1c09e1c0e0247.js"> <link data-chunk="core-icons-chevron-down-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-chevron-down-svg.e20b84e9871bd73d1b8c.js"> <link data-chunk="core-icons-key-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-key-svg.71e09670b926900508b8.js"> <link data-chunk="core-icons-eye-off-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-eye-off-svg.b2b8b241b4b324dfd9c1.js"> <link data-chunk="core-icons-book-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-book-svg.556c5a2abddd44b2284c.js"> <link data-chunk="core-icons-message-circle-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-message-circle-svg.1e24c2d2eb4f9a6ede5d.js"> <link data-chunk="New" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/New.809992a323beb6b1920f.js"> <link data-chunk="core-icons-gauge-circle-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-gauge-circle-svg.fff25782546fef314a09.js"> <link data-chunk="core-icons-inbox-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-inbox-svg.01c2ecb759e417a98bb8.js"> <link data-chunk="routes-Dash-ChatGPT-CopilotInstalledPage" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/1231.f80a04007595f4936e51.js"> <link data-chunk="routes-Dash-ChatGPT-CopilotInstalledPage" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/routes-Dash-ChatGPT-CopilotInstalledPage.62a9fb1d734b15803ce5.js"> <link data-chunk="core-icons-unlock-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-unlock-svg.d27591cc9e0be731e26d.js"> <link data-chunk="core-icons-alert-triangle-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-alert-triangle-svg.aa5960e73a548f38e8bd.js"> <link data-chunk="core-icons-chevron-right-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-chevron-right-svg.34d126524d8ea236d174.js"> <link data-chunk="core-icons-plus-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-plus-svg.a49fb76ac2661b5e1c7e.js"> <link data-chunk="core-icons-folder-plus-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-folder-plus-svg.2c200438e59611867262.js"> <link data-chunk="core-icons-file-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-file-svg.24d3e20044ef331cf0d2.js"> <link data-chunk="core-icons-eye-svg" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/core-icons-eye-svg.b2103692a3c209893efe.js"> <link data-chunk="main" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/ui-styles.1c9b1263c4b136f42e7c.css"> <link data-chunk="main" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/main.ef84cc15c1ff3d327657.css"> <link data-chunk="routes-SuperHub" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/2395.593cd7b6ba0bdb6787a8.css"> <link data-chunk="routes-SuperHub" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/777.75e3fc491ee8103c63a3.css"> <link data-chunk="routes-SuperHub" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/routes-SuperHub.18e10a8c3a8566f5cd89.css"> <link data-chunk="Header" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/Header.862d4391741934767cc6.css"> <link data-chunk="routes-Reference" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/routes-Reference.60a8dcec37a13b0b71c5.css"> <link data-chunk="routes-PageNotFound" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/routes-PageNotFound.d8afd1171cf7a455eed7.css"> <link data-chunk="routes-Doc" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/routes-Doc.f7ce97dc8d07fa3e6aaa.css"> <link data-chunk="routes-Landing" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/routes-Landing.332d7eed7b2d976c458e.css"> <link data-chunk="CustomPage" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/CustomPage.38a39d6ce8b0e2afad5a.css"> <link data-chunk="routes-Tutorials" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/routes-Tutorials.c978ddef3555c7447f00.css"> <link data-chunk="routes-Discuss" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/routes-Discuss.571e99fd5e02a59c06dd.css"> <link data-chunk="List" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/List.0191c4b0bafb7ea55b1e.css"> <link data-chunk="routes-SuperHub-Routes" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/routes-SuperHub-Routes.0bad54c5a8928aaaf4c6.css"> <link data-chunk="Page" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/Page.14c9c3c968352dbbe7dd.css"> <link data-chunk="routes-Changelog" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/routes-Changelog.28957affcff81e852361.css"> <link data-chunk="Editor" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/Editor.bdadb1e8cc8aa84d5e86.css"> <link data-chunk="New" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/New.14c9c3c968352dbbe7dd.css"> <link data-chunk="routes-Dash-ChatGPT-CopilotInstalledPage" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/routes-Dash-ChatGPT-CopilotInstalledPage.e465d3c8429ef097e6ed.css"><style title="rm-custom-css">:root{--project-color-primary:#44A28F;--project-color-inverse:#222;--recipe-button-color:#44A28F;--recipe-button-color-hover:#265a50;--recipe-button-color-active:#173630;--recipe-button-color-focus:rgba(68, 162, 143, 0.25);--recipe-button-color-disabled:#c9e9e2}[id=enterprise] .ReadMeUI[is=AlgoliaSearch]{--project-color-primary:#44A28F;--project-color-inverse:#222}a{color:var(--color-link-primary,#44a28f)}a:hover{color:var(--color-link-primary-darken-5,#265a50)}a.text-muted:hover{color:var(--color-link-primary,#44a28f)}.btn.btn-primary{background-color:#44a28f}.btn.btn-primary:hover{background-color:#265a50}.theme-line #hub-landing-top h2{color:#44a28f}#hub-landing-top .btn:hover{color:#44a28f}.theme-line #hub-landing-top .btn:hover{color:#fff}.theme-solid header#hub-header #header-top{background-color:#44a28f}.theme-solid.header-gradient header#hub-header #header-top{background:linear-gradient(to bottom,#44a28f,#227866)}.theme-solid.header-custom header#hub-header #header-top{background-image:url(undefined)}.theme-line header#hub-header #header-top{border-bottom-color:#44a28f}.theme-line header#hub-header #header-top .btn{background-color:#44a28f}header#hub-header #header-top #header-logo{width:68px;height:40px;margin-top:0;background-image:url(https://files.readme.io/4680beec6938bde00138451225326037ace6f6e8011c88b92e902c051dfb922e-small-ror-logo-2600px.png)}#hub-subheader-parent #hub-subheader .hub-subheader-breadcrumbs .dropdown-menu a:hover{background-color:#44a28f}#subheader-links a.active{color:#44a28f!important;box-shadow:inset 0 -2px 0 #44a28f}#subheader-links a:hover{color:#44a28f!important;box-shadow:inset 0 -2px 0 #44a28f;opacity:.7}.discussion .submit-vote.submit-vote-parent.voted a.submit-vote-button{background-color:#44a28f}section#hub-discuss .discussion a .discuss-body h4{color:#44a28f}section#hub-discuss .discussion a:hover .discuss-body h4{color:#265a50}#hub-subheader-parent #hub-subheader.sticky-header.sticky{border-bottom-color:#44a28f}#hub-subheader-parent #hub-subheader.sticky-header.sticky .search-box{border-bottom-color:#44a28f}#hub-search-results h3 em{color:#44a28f}.main_background,.tag-item{background:#44a28f!important}.main_background:hover{background:#265a50!important}.main_color{color:#44a28f!important}.border_bottom_main_color{border-bottom:2px solid #44a28f}.main_color_hover:hover{color:#44a28f!important}section#hub-discuss h1{color:#44a28f}#hub-reference .hub-api .api-definition .api-try-it-out.active{border-color:#44a28f;background-color:#44a28f}#hub-reference .hub-api .api-definition .api-try-it-out.active:hover{background-color:#265a50;border-color:#265a50}#hub-reference .hub-api .api-definition .api-try-it-out:hover{border-color:#44a28f;color:#44a28f}#hub-reference .hub-reference .logs .logs-empty .logs-login-button,#hub-reference .hub-reference .logs .logs-login .logs-login-button{background-color:var(--project-color-primary,#44a28f);border-color:var(--project-color-primary,#44a28f)}#hub-reference .hub-reference .logs .logs-empty .logs-login-button:hover,#hub-reference .hub-reference .logs .logs-login .logs-login-button:hover{background-color:#265a50;border-color:#265a50}#hub-reference .hub-reference .logs .logs-empty>svg>path,#hub-reference .hub-reference .logs .logs-login>svg>path{fill:#44a28f;fill:var(--project-color-primary,#44a28f)}#hub-reference .hub-reference .logs:last-child .logs-empty,#hub-reference .hub-reference .logs:last-child .logs-login{margin-bottom:35px}#hub-reference .hub-reference .hub-reference-section .hub-reference-left header .hub-reference-edit:hover{color:#44a28f}.main-color-accent{border-bottom:3px solid #44a28f;padding-bottom:8px}/*! BEGIN HUB_CUSTOM_STYLES *//*! END HUB_CUSTOM_STYLES */</style><meta name="loadedProject" content="ror"><script>var storedColorMode = `light` === 'system' ? window.localStorage.getItem('color-scheme') : `light` document.querySelector('[data-color-mode]').setAttribute('data-color-mode', storedColorMode)</script><script id="config" type="application/json" data-json="{"algoliaIndex":"readme_search_v2","amplitude":{"apiKey":"dc8065a65ef83d6ad23e37aaf014fc84","enabled":true},"asset_url":"https://cdn.readme.io","domain":"readme.io","domainFull":"https://dash.readme.com","encryptedLocalStorageKey":"ekfls-2024-05","fullstory":{"enabled":true,"orgId":"FSV9A"},"metrics":{"billingCronEnabled":"true","dashUrl":"https://m.readme.io","defaultUrl":"https://m.readme.io","exportMaxRetries":12,"wsUrl":"wss://m.readme.io"},"proxyUrl":"https://try.readme.io","readmeRecaptchaSiteKey":"6LesVBYpAAAAAESOCHOyo2kF9SZXPVb54Nwf3i2x","releaseVersion":"5.281.0","sentry":{"dsn":"https://3bbe57a973254129bcb93e47dc0cc46f@o343074.ingest.sentry.io/2052166","enabled":true,"tracesSampleRate":0},"shMigration":{"promoVideo":"","forceWaitlist":false},"sslBaseDomain":"readmessl.com","sslGenerationService":"ssl.readmessl.com","stripePk":"pk_live_5103PML2qXbDukVh7GDAkQoR4NSuLqy8idd5xtdm9407XdPR6o3bo663C1ruEGhXJjpnb2YCpj8EU1UvQYanuCjtr00t1DRCf2a","superHub":{"newProjectsEnabled":true},"wootric":{"accountToken":"NPS-122b75a4","enabled":true}}"></script></head><body class="body-none theme-solid header-solid header-bg-size-auto header-bg-pos-tl header-overlay-triangles reference-layout-row lumosity-normal "><div id="ssr-top"></div><div id="ssr-main"><div class="App ThemeContext ThemeContext_dark " style="--color-primary:#44A28F;--color-primary-inverse:#fff;--color-primary-alt:#227866;--color-primary-darken-10:#357e6f;--color-primary-darken-20:#265a50;--color-primary-alpha-25:rgba(68, 162, 143, 0.25);--color-link-primary:#44A28F;--color-link-primary-darken-5:#3c907f;--color-link-primary-darken-10:#357e6f;--color-link-primary-darken-20:#265a50;--color-link-primary-alpha-50:rgba(68, 162, 143, 0.5);--color-link-primary-alpha-25:rgba(68, 162, 143, 0.25);--color-link-background:rgba(68, 162, 143, 0.09);--color-link-text:#fff;--color-login-link:#018ef5;--color-login-link-text:#fff;--color-login-link-darken-10:#0171c2;--color-login-link-primary-alpha-50:rgba(1, 142, 245, 0.5)"><header class="Header3zzata9F_ZPQ rm-Header "><div class="rm-Header-top Header-topuTMpygDG4e1V"><div class="rm-Container rm-Container_flex"><div style="outline:none" tabindex="-1"><a href="#content" target="_self" class="Button Button_md rm-JumpTo Header-jumpTo3IWKQXmhSI5D Button_primary">Jump to Content</a></div><div class="rm-Header-left Header-leftADQdGVqx1wqU"><a class="rm-Logo Header-logo1Xy41PtkzbdG" href="https://ror.org" target="_self"><img alt="ROR" class="rm-Logo-img rm-Logo-img_lg Header-logo-img3YvV4lcGKkeb" src="https://files.readme.io/4680beec6938bde00138451225326037ace6f6e8011c88b92e902c051dfb922e-small-ror-logo-2600px.png"/></a><a class="Button Button_md rm-Header-link rm-Header-top-link Button_slate_text Header-link2tXYTgXq85zW" href="https://github.com/ror-community/ror-roadmap/issues/new/choose" target="_self" to="https://github.com/ror-community/ror-roadmap/issues/new/choose">Report a bug or request a feature</a><a class="Button Button_md rm-Header-link rm-Header-top-link Button_slate_text Header-link2tXYTgXq85zW" href="mailto:support@ror.org" target="_self" to="mailto:support@ror.org">Contact support</a></div><div class="rm-Header-left Header-leftADQdGVqx1wqU Header-left_mobile1RG-X93lx6PF"><div><button aria-label="Toggle navigation menu" class="icon-menu menu3d6DYNDa3tk5" type="button"></button><div class=""><div class="Flyout95xhYIIoTKtc undefined rm-Flyout" data-testid="flyout"><div class="MobileFlyout1hHJpUd-nYkd"><a class="rm-MobileFlyout-item NavItem-item1gDDTqaXGhm1 NavItem-item_mobile1qG3gd-Mkck- " href="/" target="_self"><i class="icon-landing-page-2 NavItem-badge1qOxpfTiALoz"></i><span class="NavItem-textSlZuuL489uiw">Home</span></a><a aria-current="page" class="rm-MobileFlyout-item NavItem-item1gDDTqaXGhm1 NavItem-item_mobile1qG3gd-Mkck- active" href="/docs" target="_self"><i class="icon-guides NavItem-badge1qOxpfTiALoz"></i><span class="NavItem-textSlZuuL489uiw">Guides</span></a><a class="rm-MobileFlyout-item NavItem-item1gDDTqaXGhm1 NavItem-item_mobile1qG3gd-Mkck- " href="/changelog" target="_self"><i class="icon-changelog NavItem-badge1qOxpfTiALoz"></i><span class="NavItem-textSlZuuL489uiw">Changelog</span></a><select class="Select Select_md NavItem-item1gDDTqaXGhm1 NavItem-item_select3UEfLN-oSjxp NavItem-item_mobile1qG3gd-Mkck-"><option selected="" data-url="#" value="1">v1</option><option data-url="/v2/docs" value="2">v2</option></select><hr class="MobileFlyout-divider10xf7R2X1MeW"/><a class="rm-MobileFlyout-item NavItem-item1gDDTqaXGhm1 NavItem-item_mobile1qG3gd-Mkck- NavItem_dropdown-muted1xJVuczwGc74" href="https://github.com/ror-community/ror-roadmap/issues/new/choose" rel="noopener" target="_blank" to="https://github.com/ror-community/ror-roadmap/issues/new/choose">Report a bug or request a feature</a><a class="rm-MobileFlyout-item NavItem-item1gDDTqaXGhm1 NavItem-item_mobile1qG3gd-Mkck- NavItem_dropdown-muted1xJVuczwGc74" href="mailto:support@ror.org" target="_self" to="mailto:support@ror.org">Contact support</a><a class="rm-MobileFlyout-item NavItem-item1gDDTqaXGhm1 NavItem-item_mobile1qG3gd-Mkck- NavItem_dropdown-muted1xJVuczwGc74" href="/login?redirect_uri=/docs/matching" target="_self" to="/login?redirect_uri=/docs/matching">Log In</a><a class="MobileFlyout-logo3Lq1eTlk1K76 Header-logo1Xy41PtkzbdG rm-Logo" href="https://ror.org" target="_self"><img alt="ROR" class="Header-logo-img3YvV4lcGKkeb rm-Logo-img" src="https://files.readme.io/4680beec6938bde00138451225326037ace6f6e8011c88b92e902c051dfb922e-small-ror-logo-2600px.png"/></a></div></div></div></div><div class="Header-left-nav2xWPWMNHOGf_"><i class="icon-guides Header-left-nav-icon10glJKFwewOv"></i>Guides</div></div><div class="rm-Header-right Header-right21PC2XTT6aMg"><span class="Header-right_desktop14ja01RUQ7HE"><a href="/login?redirect_uri=/docs/matching" target="_self" class="Button Button_slate_text Button_md Header-link2tXYTgXq85zW undefined NavItem_mdrYO3ChA2kYvP rm-Header-top-link rm-Header-top-link_login Button_primary">Log In</a></span><div class="Header-searchtb6Foi0-D9Vx"><button aria-label="Search ⌘k" class="rm-SearchToggle" data-symbol="⌘"><div class="rm-SearchToggle-icon icon-search1"></div></button></div></div></div></div><div class="Header-bottom2eLKOFXMEmh5 rm-Header-bottom "><div class="rm-Container rm-Container_flex"><nav class="Header-leftADQdGVqx1wqU"><div class="rm-VersionDropdown Dropdown Dropdown_closed"><button aria-haspopup="dialog" class="Button Button_slate_text Button_md rm-Header-bottom-link Dropdown-toggle Button_primary" type="button"><span>v1</span><i class="icon icon-chevron-down"></i></button></div><a class="Button Button_md rm-Header-link rm-Header-bottom-link Button_slate_text Header-bottom-link_mobile " href="/" target="_self"><i class="icon-landing-page-2"></i><span>Home</span></a><a aria-current="page" class="Button Button_md rm-Header-link rm-Header-bottom-link Button_slate_text Header-bottom-link_mobile active" href="/docs" target="_self"><i class="icon-guides"></i><span>Guides</span></a><a class="Button Button_md rm-Header-link rm-Header-bottom-link Button_slate_text Header-bottom-link_mobile " href="/changelog" target="_self"><i class="icon-changelog"></i><span>Changelog</span></a></nav><button align="center" justify="between" style="--flex-gap:var(--xs)" class="Button Button_sm Flex Flex_row MobileSubnav1DsTfasXloM2 Button_contrast Button_contrast_outline" type="button"><span class="Button-label">Match organization names to ROR IDs</span><span class="IconWrapper Icon-wrapper2z2wVIeGsiUy"><svg fill="none" viewBox="0 0 24 24" class="Icon Icon3_D2ysxFZ_ll Icon-svg2Lm7f6G9Ly5a" data-name="chevron-up-down" role="img" style="--icon-color:inherit;--icon-size:inherit;--icon-stroke-width:2px"><path stroke="currentColor" stroke-linecap="round" stroke-linejoin="round" d="m6 16 6 6 6-6M18 8l-6-6-6 6" class="icon-stroke-width"></path></svg></span></button><div class="rm-Header-search Header-searchtb6Foi0-D9Vx rm-Header-search_feather Header-search_featherYsmQBn55F3d9"><button aria-label="Search ⌘k" class="rm-SearchToggle" data-symbol="⌘"><div class="rm-SearchToggle-icon icon-search1"></div><div class="Header-search-placeholder3Vx4OmMPcjAi rm-SearchToggle-placeholder">Search</div><div class="rm-SearchToggle-shortcut"></div></button></div></div></div><div class="hub-search-results--reactApp " id="hub-search-results"><div class="hub-container"><div class="modal-backdrop show-modal rm-SearchModal" role="button" tabindex="0"></div></div></div></header><main class="rm-Guides"><div class="rm-Container rm-Container_flex"><nav aria-label="Page navigation" class="rm-Sidebar hub-sidebar reference-redesign Nav3C5f8FcjkaHj rm-Sidebar_guides" id="hub-sidebar"><div class="Sidebar1t2G1ZJq-vU1 rm-Sidebar hub-sidebar-content"><section class="Sidebar-listWrapper6Q9_yUrG906C rm-Sidebar-section"><h2 class="Sidebar-headingTRQyOa2pk0gh rm-Sidebar-heading">Getting Started with ROR</h2><ul class="Sidebar-list3cZWQLaBf9k8 rm-Sidebar-list"><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless text-wrap rm-Sidebar-link" target="_self" href="/docs/basics"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">ROR basics</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless text-wrap rm-Sidebar-link" target="_self" href="/docs/identifier"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Identifier pattern</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless text-wrap rm-Sidebar-link" target="_self" href="/docs/display"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Logos and display guidelines</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless text-wrap rm-Sidebar-link" target="_self" href="/docs/integrations"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">See who uses ROR</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless text-wrap rm-Sidebar-link" target="_self" href="/docs/get-involved"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Get involved</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless text-wrap rm-Sidebar-link" target="_self" href="/docs/feedback-docs"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Community feedback documents</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless text-wrap rm-Sidebar-link" target="_self" href="/docs/contact"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Contact us</span></span></a></li></ul></section><section class="Sidebar-listWrapper6Q9_yUrG906C rm-Sidebar-section"><h2 class="Sidebar-headingTRQyOa2pk0gh rm-Sidebar-heading">ROR Metadata</h2><ul class="Sidebar-list3cZWQLaBf9k8 rm-Sidebar-list"><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless text-wrap rm-Sidebar-link" target="_self" href="/docs/updates"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Updates and curation</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless text-wrap rm-Sidebar-link" target="_self" href="/docs/data-structure"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Data structure</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless text-wrap rm-Sidebar-link" target="_self" href="/docs/fields"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Fields and sub-fields</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless text-wrap rm-Sidebar-link" target="_self" href="/docs/relationships"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Relationships and hierarchies</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless text-wrap rm-Sidebar-link" target="_self" href="/docs/schema-versions"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Schema versions</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless text-wrap rm-Sidebar-link" target="_self" href="/docs/schema-v2"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Schema 2.0</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless text-wrap rm-Sidebar-link" target="_self" href="/docs/schema-2-1"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Schema 2.1</span></span></a></li></ul></section><section class="Sidebar-listWrapper6Q9_yUrG906C rm-Sidebar-section"><h2 class="Sidebar-headingTRQyOa2pk0gh rm-Sidebar-heading">ROR REST API</h2><ul class="Sidebar-list3cZWQLaBf9k8 rm-Sidebar-list"><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless text-wrap rm-Sidebar-link" target="_self" href="/docs/rest-api"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">About the ROR REST API</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless text-wrap rm-Sidebar-link" target="_self" href="/docs/api-single"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Retrieve a single record</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless text-wrap rm-Sidebar-link" target="_self" href="/docs/api-list"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Retrieve a list of records</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless text-wrap rm-Sidebar-link" target="_self" href="/docs/api-filtering"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Filtering</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless text-wrap rm-Sidebar-link" target="_self" href="/docs/api-paging"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Paging</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless text-wrap rm-Sidebar-link" target="_self" href="/docs/api-query"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Query parameter</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless text-wrap rm-Sidebar-link" target="_self" href="/docs/api-advanced-query"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Advanced query parameter</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless text-wrap rm-Sidebar-link" target="_self" href="/docs/api-affiliation"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Affiliation parameter</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless text-wrap rm-Sidebar-link" target="_self" href="/docs/api-versions"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">API versions</span></span></a></li></ul></section><section class="Sidebar-listWrapper6Q9_yUrG906C rm-Sidebar-section"><h2 class="Sidebar-headingTRQyOa2pk0gh rm-Sidebar-heading">ROR Tools & Services</h2><ul class="Sidebar-list3cZWQLaBf9k8 rm-Sidebar-list"><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless text-wrap rm-Sidebar-link" target="_self" href="/docs/data-dump"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Data dump</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless text-wrap rm-Sidebar-link" target="_self" href="/docs/web-search"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Web search</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless text-wrap rm-Sidebar-link" target="_self" href="/docs/openrefine-reconciler"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">OpenRefine reconciler</span></span></a></li></ul></section><section class="Sidebar-listWrapper6Q9_yUrG906C rm-Sidebar-section"><h2 class="Sidebar-headingTRQyOa2pk0gh rm-Sidebar-heading">Collecting ROR IDs</h2><ul class="Sidebar-list3cZWQLaBf9k8 rm-Sidebar-list"><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless text-wrap rm-Sidebar-link" target="_self" href="/docs/forms"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Create ROR-powered forms</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a aria-current="page" class="Sidebar-link2Dsha-r-GKh2 childless text-wrap rm-Sidebar-link active" target="_self" href="/docs/matching"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Match organization names to ROR IDs</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless text-wrap rm-Sidebar-link" target="_self" href="/docs/mapping"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Map other organization IDs to ROR IDs</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless text-wrap rm-Sidebar-link" target="_self" href="/docs/grid"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Transition from GRID to ROR</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless text-wrap rm-Sidebar-link" target="_self" href="/docs/funder-registry"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Transition from Open Funder Registry to ROR</span></span></a></li></ul></section><section class="Sidebar-listWrapper6Q9_yUrG906C rm-Sidebar-section"><h2 class="Sidebar-headingTRQyOa2pk0gh rm-Sidebar-heading">Sending ROR IDs</h2><ul class="Sidebar-list3cZWQLaBf9k8 rm-Sidebar-list"><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless text-wrap rm-Sidebar-link" target="_self" href="/docs/crossref"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Add ROR IDs to Crossref DOIs</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless text-wrap rm-Sidebar-link" target="_self" href="/docs/datacite"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Add ROR IDs to DataCite DOIs</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless text-wrap rm-Sidebar-link" target="_self" href="/docs/jats"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Add ROR IDs to JATS XML</span></span></a></li><li class="Sidebar-item23D-2Kd61_k3"><a class="Sidebar-link2Dsha-r-GKh2 childless text-wrap rm-Sidebar-link" target="_self" href="/docs/orcid"><span class="Sidebar-link-textLuTE1ySm4Kqn"><span class="Sidebar-link-text_label1gCT_uPnx7Gu">Add ROR IDs to ORCID records</span></span></a></li></ul></section><div class="readme-logo" id="readmeLogo">Powered by <a aria-label="ReadMe" href="https://readme.com?ref_src=hub&project=ror" style="color:unset"><i class="icon icon-readme" style="display:inline-block;min-width:71px"></i></a></div></div></nav><article class="rm-Article " id="content"><header id="content-head"><div class="row clearfix"><div class="col-xs-9"><h1>Match organization names to ROR IDs</h1></div><div class="col-xs-3"><a class="suggestEdits" rel="nofollow" href="/edit/matching"><i aria-hidden="true" class="icon icon-edit"></i> Suggest Edits</a></div></div></header><div class="grid-container-fluid" id="content-container"><section class="content-body grid-75"><div dehydrated="<p>If you have organization names or full affiliation strings stored in your system as text, there are several approaches to matching those text strings to ROR IDs. </p> <p>The approaches given below are for cases when you have a list, a spreadsheet, or a database with organization information as text strings, often with &quot;extra&quot; text such as a department or address as well as the organization&#x27;s name, but no corresponding organization IDs. </p> <p>Examples of organization names and affiliation information as text strings and the corresponding ROR ID: </p> <ul> <li>University of Haifa &gt; <a href="https://ror.org/02f009v59" target="" title="">https://ror.org/02f009v59</a> </li> <li>University of ManchesterGreater Manchester Mental Health NHS Foundation TrustNational Institute for Health Research (NIHR) Greater Manchester Patient Safety Translational Research Centre &gt; <a href="https://ror.org/05sb89p83" target="" title="">https://ror.org/05sb89p83</a> </li> <li>Atmospheric Sciences and Global Change Division, Pacific Northwest National Laboratory, Richland, WA, USA &gt; <a href="https://ror.org/05h992307" target="" title="">https://ror.org/05h992307</a> </li> </ul> <blockquote class="callout callout_info" theme="📘"><h2 class="callout-heading"><span class="callout-icon">📘</span><p>Mapping names and IDs to ROR</p></h2><p>If you have organization names along with another global organization ID (Crossref Funder ID, GRID, ISNI, or Wikidata), you may find quicker, more accurate results by mapping those other IDs to ROR. See <a href="/docs/mapping" target="" title="" class="doc-link" data-sidebar="mapping">Map other organization ID types to ROR</a>. </p><p>If you need to match ROR IDs to user input in a web application, see <a href="/docs/forms" target="" title="" class="doc-link" data-sidebar="forms">Create ROR-powered typeaheads in forms</a>.</p></blockquote> <h2 class="heading heading-2 header-scroll" align=""><div class="heading-anchor anchor waypoint" id="match-organization-names-to-ror-ids-using-the-ror-api"></div><div class="heading-text"><div id="section-match-organization-names-to-ror-i-ds-using-the-ror-api" class="heading-anchor_backwardsCompatibility"></div>Match organization names to ROR IDs using the ROR API</div><a aria-label="Skip link to Match organization names to ROR IDs using the ROR API" class="heading-anchor-icon fa fa-anchor" href="#match-organization-names-to-ror-ids-using-the-ror-api"></a></h2> <h3 class="heading heading-3 header-scroll" align=""><div class="heading-anchor anchor waypoint" id="query-vs-affiliation-parameter"></div><div class="heading-text"><div id="section-query-vs-affiliation-parameter" class="heading-anchor_backwardsCompatibility"></div>Query vs affiliation parameter</div><a aria-label="Skip link to Query vs affiliation parameter" class="heading-anchor-icon fa fa-anchor" href="#query-vs-affiliation-parameter"></a></h3> <p>The <a href="/docs/api-about" target="" title="" class="doc-link" data-sidebar="api-about">ROR API</a> offers 2 ways to search ROR records, which work slightly differently and return different results:</p> <ul> <li> <p><strong><a href="#affiliation-parameter-approach" target="" title="">Affiliation parameter</a></strong> <button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">/organizations?affiliation=</code>: Searches <button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">name</code>, <button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">aliases</code>, and <button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">labels</code> fields using different search algorithms and returns the best match(es) based on matching score. Includes matching score and true/false indicator of whether the score is high enough to be considered a reliable match. Produces about 85% correct matches in our tests; individual implementations may see better or worse results. </p> </li> <li> <p><strong><a href="#query-parameter-approach" target="" title="">Query parameter</a></strong> <button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">/organizations?query=</code>: Searches <button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">name</code>, <button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">aliases</code>, <button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">labels</code>, <button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">acronyms</code>, and <button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">external_ids</code> fields in ROR records and returns all matching records. Does NOT include a matching score or true/false indicator of whether the score is high enough to be considered a reliable match.</p> </li> </ul> <p>For cases where you have relatively unique organization names or full affiliation strings, use the <a href="#affiliation-parameter-approach" target="" title="">affiliation parameter approach</a>. Works for both English and non-English name variations. Examples:</p> <ul> <li>Incorporated Research Institutions for Seismology (IRIS)</li> <li>Universitätsbibliothek der Ludwig-Maximilians-Universität München</li> <li>Department of Civil and Industrial Engineering, University of Pisa, Largo Lucio Lazzarino 2, Pisa 56126, Italy</li> </ul> <p>For cases where you have very common organization names, use the <a href="#query-parameter-approach" target="" title="">query parameter approach</a> to look for keywords from the organization&#x27;s name or the exact name of the organization surrounded by double quotation marks, and consider using filters for organization type and country. Examples:</p> <ul> <li>Ministry of Health</li> <li>National Research Council</li> <li>York University</li> </ul> <blockquote class="callout callout_info" theme="📘"><h2 class="callout-heading"><span class="callout-icon">📘</span><p>Retrieving active and inactive organizations</p></h2><p>By default, both the affiliation parameter and the query parameter will return only records with an active <a href="/docs/data-structure#status" target="" title="" class="doc-link" data-sidebar="data-structure#status">status</a>: <button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">status: &quot;active&quot;</code>. Consider whether you also want to retrieve records with an inactive status; inactive records generally represent organizations that no longer operate. See <a href="/docs/api-filtering" target="" title="" class="doc-link" data-sidebar="api-filtering">API filtering</a> for details. </p><p>Be aware too that inactive organizations may be succeeded by a new organization under a different name with a different ROR ID. If you do retrieve inactive organizations, check the <button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">relationships</code> field of an inactive record to see if it has a <a href="/docs/data-structure#relationships" target="" title="" class="doc-link" data-sidebar="data-structure#relationships">Successor organization</a>.</p></blockquote> <h3 class="heading heading-3 header-scroll" align=""><div class="heading-anchor anchor waypoint" id="affiliation-parameter-approach"></div><div class="heading-text"><div id="section-affiliation-parameter-approach" class="heading-anchor_backwardsCompatibility"></div>Affiliation parameter approach</div><a aria-label="Skip link to Affiliation parameter approach" class="heading-anchor-icon fa fa-anchor" href="#affiliation-parameter-approach"></a></h3> <p>Searches <button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">name</code>, <button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">aliases</code> and <button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">labels</code> fields using different search algorithms and returns the best match(es) based on matching score using the format <button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">https://api.ror.org/organizations?affiliation=&lt;URL-encoded string&gt;</code>. For the full list of fields returned, see <a href="/docs/fields" target="" title="" class="doc-link" data-sidebar="fields">Fields and sub-fields</a>.</p> <div class="CodeTabs CodeTabs_initial theme-light"><div class="CodeTabs-toolbar" role="tablist"><button aria-selected="true" class="CodeTabs_active" role="tab" type="button">cURL</button></div><div class="CodeTabs-inner" role="tabpanel"><pre><button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang-curl theme-light" data-lang="curl" name="" tabindex="0">curl &#x27;https://api.ror.org/v1/organizations?affiliation=university+of+wisconsin+madison&#x27; | json_pp </code></pre></div></div> <p>If there&#x27;s a high-confidence match, it will appear as the first result, with <button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">&quot;chosen&quot;: true</code>. Other results and their matching score will also be returned, but if you&#x27;re automating this process using a script, we recommend using results with <button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">&quot;chosen&quot;: true</code> rather than relying on the score. Results are paginated: see <a href="/docs/api-paging" target="" title="" class="doc-link" data-sidebar="api-paging">API paging</a> for details.</p> <div class="CodeTabs CodeTabs_initial theme-light"><div class="CodeTabs-toolbar" role="tablist"><button aria-selected="true" class="CodeTabs_active" role="tab" type="button">JSON</button></div><div class="CodeTabs-inner" role="tabpanel"><pre><button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang-json theme-light" data-lang="json" name="" tabindex="0">{ &quot;items&quot; : [ { &quot;chosen&quot; : true, &quot;matching_type&quot; : &quot;EXACT&quot;, &quot;organization&quot; : { &quot;acronyms&quot; : [ &quot;UW&quot; ], &quot;addresses&quot; : [ { &quot;city&quot; : &quot;Madison&quot;, &quot;country_geonames_id&quot; : null, &quot;geonames_city&quot; : { &quot;city&quot; : &quot;Madison&quot;, &quot;geonames_admin1&quot; : { &quot;ascii_name&quot; : null, &quot;code&quot; : &quot;US.WI&quot;, &quot;id&quot; : null, &quot;name&quot; : &quot;Wisconsin&quot; }, &quot;geonames_admin2&quot; : { &quot;ascii_name&quot; : null, &quot;code&quot; : null, &quot;id&quot; : null, &quot;name&quot; : null }, &quot;id&quot; : 5261457, &quot;license&quot; : { &quot;attribution&quot; : &quot;Data from geonames.org under a CC-BY 3.0 license&quot;, &quot;license&quot; : &quot;http://creativecommons.org/licenses/by/3.0/&quot; }, &quot;nuts_level1&quot; : { &quot;code&quot; : null, &quot;name&quot; : null }, &quot;nuts_level2&quot; : { &quot;code&quot; : null, &quot;name&quot; : null }, &quot;nuts_level3&quot; : { &quot;code&quot; : null, &quot;name&quot; : null } }, &quot;lat&quot; : 43.07305, &quot;line&quot; : null, &quot;lng&quot; : -89.40123, &quot;postcode&quot; : null, &quot;primary&quot; : false, &quot;state&quot; : null, &quot;state_code&quot; : null } ], &quot;aliases&quot; : [ &quot;UW–Madison&quot; ], &quot;country&quot; : { &quot;country_code&quot; : &quot;US&quot;, &quot;country_name&quot; : &quot;United States&quot; }, &quot;email_address&quot; : null, &quot;established&quot; : 1848, &quot;external_ids&quot; : { &quot;FundRef&quot; : { &quot;all&quot; : [ &quot;100007015&quot;, &quot;100008959&quot;, &quot;100005996&quot;, &quot;100007870&quot;, &quot;100008301&quot;, &quot;100008028&quot;, &quot;100008237&quot;, &quot;100008161&quot;, &quot;100010495&quot;, &quot;100009627&quot;, &quot;100010284&quot;, &quot;100005911&quot;, &quot;100007925&quot;, &quot;100005902&quot;, &quot;100012787&quot; ], &quot;preferred&quot; : &quot;100007015&quot; }, &quot;GRID&quot; : { &quot;all&quot; : &quot;grid.14003.36&quot;, &quot;preferred&quot; : &quot;grid.14003.36&quot; }, &quot;ISNI&quot; : { &quot;all&quot; : [ &quot;0000 0001 2167 3675&quot; ], &quot;preferred&quot; : null }, &quot;Wikidata&quot; : { &quot;all&quot; : [ &quot;Q838330&quot;, &quot;Q33122195&quot;, &quot;Q7662222&quot; ], &quot;preferred&quot; : &quot;Q838330&quot; } }, &quot;id&quot; : &quot;https://ror.org/01y2jtd41&quot;, &quot;ip_addresses&quot; : [], &quot;labels&quot; : [ { &quot;iso639&quot; : &quot;es&quot;, &quot;label&quot; : &quot;Universidad de Wisconsin-Madison&quot; }, { &quot;iso639&quot; : &quot;fr&quot;, &quot;label&quot; : &quot;Université du Wisconsin à Madison&quot; } ], &quot;links&quot; : [ &quot;http://www.wisc.edu/&quot; ], &quot;name&quot; : &quot;University of Wisconsin–Madison&quot;, &quot;relationships&quot; : [ { &quot;id&quot; : &quot;https://ror.org/05cb4rb43&quot;, &quot;label&quot; : &quot;Morgridge Institute for Research&quot;, &quot;type&quot; : &quot;Child&quot; }, { &quot;id&quot; : &quot;https://ror.org/04gq8q482&quot;, &quot;label&quot; : &quot;North Temperate Lakes Long Term Ecological Research&quot;, &quot;type&quot; : &quot;Child&quot; }, { &quot;id&quot; : &quot;https://ror.org/03ydkyb10&quot;, &quot;label&quot; : &quot;University of Wisconsin System&quot;, &quot;type&quot; : &quot;Parent&quot; }, { &quot;id&quot; : &quot;https://ror.org/03b8vas82&quot;, &quot;label&quot; : &quot;National Atmospheric Deposition Program&quot;, &quot;type&quot; : &quot;Related&quot; }, { &quot;id&quot; : &quot;https://ror.org/04r3s7465&quot;, &quot;label&quot; : &quot;McMurdo Dry Valleys Long Term Ecological Research&quot;, &quot;type&quot; : &quot;Related&quot; }, { &quot;id&quot; : &quot;https://ror.org/02kj3rm24&quot;, &quot;label&quot; : &quot;Wisconsin Geological and Natural History Survey&quot;, &quot;type&quot; : &quot;Child&quot; } ], &quot;status&quot; : &quot;active&quot;, &quot;types&quot; : [ &quot;Education&quot;, &quot;Funder&quot; ], &quot;wikipedia_url&quot; : &quot;http://en.wikipedia.org/wiki/University_of_Wisconsin%E2%80%93Madison&quot; }, &quot;score&quot; : 1, &quot;substring&quot; : &quot;university of wisconsin madison&quot; }, { &quot;chosen&quot; : false, &quot;matching_type&quot; : &quot;EXACT&quot;, &quot;organization&quot; : { &quot;acronyms&quot; : [ &quot;UWHC&quot; ], &quot;addresses&quot; : [ { &quot;city&quot; : &quot;Madison&quot;, &quot;country_geonames_id&quot; : null, &quot;geonames_city&quot; : { &quot;city&quot; : &quot;Madison&quot;, &quot;geonames_admin1&quot; : { &quot;ascii_name&quot; : null, &quot;code&quot; : &quot;US.WI&quot;, &quot;id&quot; : null, &quot;name&quot; : &quot;Wisconsin&quot; }, &quot;geonames_admin2&quot; : { &quot;ascii_name&quot; : null, &quot;code&quot; : null, &quot;id&quot; : null, &quot;name&quot; : null }, &quot;id&quot; : 5261457, &quot;license&quot; : { &quot;attribution&quot; : &quot;Data from geonames.org under a CC-BY 3.0 license&quot;, &quot;license&quot; : &quot;http://creativecommons.org/licenses/by/3.0/&quot; }, &quot;nuts_level1&quot; : { &quot;code&quot; : null, &quot;name&quot; : null }, &quot;nuts_level2&quot; : { &quot;code&quot; : null, &quot;name&quot; : null }, &quot;nuts_level3&quot; : { &quot;code&quot; : null, &quot;name&quot; : null } }, &quot;lat&quot; : 43.07305, &quot;line&quot; : null, &quot;lng&quot; : -89.40123, &quot;postcode&quot; : null, &quot;primary&quot; : false, &quot;state&quot; : null, &quot;state_code&quot; : null } ], &quot;aliases&quot; : [ &quot;UW Hospital and Clinics&quot;, &quot;University of Wisconsin Health University Hospital&quot;, &quot;University of Wisconsin Hospital and Clinics&quot;, &quot;University of Wisconsin-Madison Hospital&quot;, &quot;Wisconsin General Hospital&quot; ], &quot;country&quot; : { &quot;country_code&quot; : &quot;US&quot;, &quot;country_name&quot; : &quot;United States&quot; }, &quot;email_address&quot; : null, &quot;established&quot; : 1924, &quot;external_ids&quot; : { &quot;GRID&quot; : { &quot;all&quot; : &quot;grid.412647.2&quot;, &quot;preferred&quot; : &quot;grid.412647.2&quot; }, &quot;ISNI&quot; : { &quot;all&quot; : [ &quot;0000 0000 9209 0955&quot; ], &quot;preferred&quot; : null }, &quot;Wikidata&quot; : { &quot;all&quot; : [ &quot;Q7896631&quot; ], &quot;preferred&quot; : null } }, &quot;id&quot; : &quot;https://ror.org/02mqqhj42&quot;, &quot;ip_addresses&quot; : [], &quot;labels&quot; : [], &quot;links&quot; : [ &quot;https://www.uwhealth.org/locations/university-hospital-170&quot; ], &quot;name&quot; : &quot;UW Health University Hospital&quot;, &quot;relationships&quot; : [ { &quot;id&quot; : &quot;https://ror.org/01e4byj08&quot;, &quot;label&quot; : &quot;University of Wisconsin Carbone Cancer Center&quot;, &quot;type&quot; : &quot;Child&quot; }, { &quot;id&quot; : &quot;https://ror.org/03e3qgk42&quot;, &quot;label&quot; : &quot;University of Wisconsin Health&quot;, &quot;type&quot; : &quot;Parent&quot; } ], &quot;status&quot; : &quot;active&quot;, &quot;types&quot; : [ &quot;Healthcare&quot; ], &quot;wikipedia_url&quot; : &quot;https://en.wikipedia.org/wiki/University_of_Wisconsin_Hospital_and_Clinics&quot; }, &quot;score&quot; : 0.87, &quot;substring&quot; : &quot;university of wisconsin madison&quot; }, { &quot;chosen&quot; : false, &quot;matching_type&quot; : &quot;EXACT&quot;, &quot;organization&quot; : { &quot;acronyms&quot; : [ &quot;UWCCC&quot; ], &quot;addresses&quot; : [ { &quot;city&quot; : &quot;Madison&quot;, &quot;country_geonames_id&quot; : null, &quot;geonames_city&quot; : { &quot;city&quot; : &quot;Madison&quot;, &quot;geonames_admin1&quot; : { &quot;ascii_name&quot; : null, &quot;code&quot; : &quot;US.WI&quot;, &quot;id&quot; : null, &quot;name&quot; : &quot;Wisconsin&quot; }, &quot;geonames_admin2&quot; : { &quot;ascii_name&quot; : null, &quot;code&quot; : null, &quot;id&quot; : null, &quot;name&quot; : null }, &quot;id&quot; : 5261457, &quot;license&quot; : { &quot;attribution&quot; : &quot;Data from geonames.org under a CC-BY 3.0 license&quot;, &quot;license&quot; : &quot;http://creativecommons.org/licenses/by/3.0/&quot; }, &quot;nuts_level1&quot; : { &quot;code&quot; : null, &quot;name&quot; : null }, &quot;nuts_level2&quot; : { &quot;code&quot; : null, &quot;name&quot; : null }, &quot;nuts_level3&quot; : { &quot;code&quot; : null, &quot;name&quot; : null } }, &quot;lat&quot; : 43.07305, &quot;line&quot; : null, &quot;lng&quot; : -89.40123, &quot;postcode&quot; : null, &quot;primary&quot; : false, &quot;state&quot; : null, &quot;state_code&quot; : null } ], &quot;aliases&quot; : [ &quot;Carbone Cancer Center&quot;, &quot;UW Carbone&quot;, &quot;UW Carbone Cancer Center&quot;, &quot;UW Carbone Comprehensive Cancer Center&quot;, &quot;UWCCC Madison&quot;, &quot;University of Wisconsin Cancer Center&quot;, &quot;University of Wisconsin Carbone Comprehensive Cancer Center&quot;, &quot;University of Wisconsin Comprehensive Cancer Center&quot;, &quot;University of Wisconsin-Madison Carbone Cancer Center&quot; ], &quot;country&quot; : { &quot;country_code&quot; : &quot;US&quot;, &quot;country_name&quot; : &quot;United States&quot; }, &quot;email_address&quot; : null, &quot;established&quot; : 1940, &quot;external_ids&quot; : { &quot;FundRef&quot; : { &quot;all&quot; : [ &quot;100007923&quot; ], &quot;preferred&quot; : &quot;100007923&quot; }, &quot;GRID&quot; : { &quot;all&quot; : &quot;grid.412639.b&quot;, &quot;preferred&quot; : &quot;grid.412639.b&quot; }, &quot;ISNI&quot; : { &quot;all&quot; : [ &quot;0000 0001 2191 1477&quot; ], &quot;preferred&quot; : null }, &quot;Wikidata&quot; : { &quot;all&quot; : [ &quot;Q7876154&quot; ], &quot;preferred&quot; : null } }, &quot;id&quot; : &quot;https://ror.org/01e4byj08&quot;, &quot;ip_addresses&quot; : [], &quot;labels&quot; : [], &quot;links&quot; : [ &quot;https://cancer.wisc.edu&quot; ], &quot;name&quot; : &quot;University of Wisconsin Carbone Cancer Center&quot;, &quot;relationships&quot; : [ { &quot;id&quot; : &quot;https://ror.org/02mqqhj42&quot;, &quot;label&quot; : &quot;UW Health University Hospital&quot;, &quot;type&quot; : &quot;Parent&quot; } ], &quot;status&quot; : &quot;active&quot;, &quot;types&quot; : [ &quot;Funder&quot;, &quot;Healthcare&quot; ], &quot;wikipedia_url&quot; : &quot;https://en.wikipedia.org/wiki/University_of_Wisconsin_Carbone_Cancer_Center&quot; }, &quot;score&quot; : 0.76, &quot;substring&quot; : &quot;university of wisconsin madison&quot; } ], &quot;number_of_results&quot; : 3 } </code></pre></div></div> <blockquote class="callout callout_warn" theme="🚧"><h2 class="callout-heading"><span class="callout-icon">🚧</span><p>Don&#x27;t automatically select the first &quot;unchosen&quot; result of an ?affiliation query with no <button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">chosen: true</code> result</p></h2><p>When no result has <button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">&quot;chosen&quot;: true</code>, the first result is not necessarily the best match for a given affiliation string. In that case, several results may have the exact same score and/or there may be no match with a high score. Because the affiliation service breaks a given affiliation string into multiple substrings and performs searches of each substring on its own as well as in combination with other substrings, a high scoring match that is not selected as chosen may be a match to only a small portion of the entire affiliation string. In these cases, it is best to respect the absence of <button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">&quot;chosen: true&quot;</code> and leave the string unmatched or add a layer of human or machine assignment, at your discretion.</p></blockquote> <h4 class="heading heading-4 header-scroll" align=""><div class="heading-anchor anchor waypoint" id="additional-request-examples"></div><div class="heading-text"><div id="section-additional-request-examples" class="heading-anchor_backwardsCompatibility"></div>Additional request examples:</div><a aria-label="Skip link to Additional request examples:" class="heading-anchor-icon fa fa-anchor" href="#additional-request-examples"></a></h4> <p>Incorporated Research Institutions for Seismology (IRIS)</p> <div class="CodeTabs CodeTabs_initial theme-light"><div class="CodeTabs-toolbar" role="tablist"><button aria-selected="true" class="CodeTabs_active" role="tab" type="button">cURL</button></div><div class="CodeTabs-inner" role="tabpanel"><pre><button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang-curl theme-light" data-lang="curl" name="" tabindex="0">curl &#x27;https://api.ror.org/v1/organizations?affiliation=Incorporated%20Research%20Institutions%20for%20Seismology%20(IRIS)&#x27; | json_pp </code></pre></div></div> <p>Universitätsbibliothek der Ludwig-Maximilians-Universität München</p> <div class="CodeTabs CodeTabs_initial theme-light"><div class="CodeTabs-toolbar" role="tablist"><button aria-selected="true" class="CodeTabs_active" role="tab" type="button">cURL</button></div><div class="CodeTabs-inner" role="tabpanel"><pre><button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang-curl theme-light" data-lang="curl" name="" tabindex="0">curl &#x27;https://api.ror.org/v1/organizations?affiliation=Universit%C3%A4tsbibliothek%20der%20Ludwig-Maximilians-Universit%C3%A4t%20M%C3%BCnchen&#x27; | json_pp </code></pre></div></div> <p>Department of Civil and Industrial Engineering, University of Pisa, Largo Lucio Lazzarino 2, Pisa 56126, Italy</p> <div class="CodeTabs CodeTabs_initial theme-light"><div class="CodeTabs-toolbar" role="tablist"><button aria-selected="true" class="CodeTabs_active" role="tab" type="button">cURL</button></div><div class="CodeTabs-inner" role="tabpanel"><pre><button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang-curl theme-light" data-lang="curl" name="" tabindex="0">curl &#x27;https://api.ror.org/v1/organizations?affiliation=Department%20of%20Civil%20and%20Industrial%20Engineering%2C%20University%20of%20Pisa%2C%20Largo%20Lucio%20Lazzarino%202%2C%20Pisa%2056126%2C%20Italy&#x27; | json_pp </code></pre></div></div> <h3 class="heading heading-3 header-scroll" align=""><div class="heading-anchor anchor waypoint" id="query-parameter-approach"></div><div class="heading-text"><div id="section-query-parameter-approach" class="heading-anchor_backwardsCompatibility"></div>Query parameter approach</div><a aria-label="Skip link to Query parameter approach" class="heading-anchor-icon fa fa-anchor" href="#query-parameter-approach"></a></h3> <p>Search all indexed fields in ROR records using the format <button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">https://api.ror.org/organizations?query=&lt;search term&gt;&amp;filter=&lt;filters&gt;</code>. We strongly recommend using <a href="/docs/filtering" target="" title="" class="doc-link" data-sidebar="filtering">organization type and country filters</a>. For more information, see the <a href="/docs/rest-api" target="" title="" class="doc-link" data-sidebar="rest-api">REST API guide</a>.</p> <div class="CodeTabs CodeTabs_initial theme-light"><div class="CodeTabs-toolbar" role="tablist"><button aria-selected="true" class="CodeTabs_active" role="tab" type="button">cURL</button></div><div class="CodeTabs-inner" role="tabpanel"><pre><button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang-curl theme-light" data-lang="curl" name="" tabindex="0">curl &#x27;https://api.ror.org/v1/organizations?query=%22Ministry+of+Health%22&amp;filter=types:Government,country.country_code:NZ&#x27; | json_pp </code></pre></div></div> <p>The response is a JSON object containing full records for the first 20 search results. Results are paginated: see <a href="/docs/api-paging" target="" title="" class="doc-link" data-sidebar="api-paging">API paging</a> for details. Matching scores are not included, but closest matches are at the beginning of the list. </p> <blockquote class="callout callout_info" theme="📘"><h2 class="callout-heading"><span class="callout-icon">📘</span><p>Query parameter searches may return many results, so some amount of human intervention may be needed to determine the matching ROR ID (if there is one).</p></h2></blockquote> <div class="CodeTabs CodeTabs_initial theme-light"><div class="CodeTabs-toolbar" role="tablist"><button aria-selected="true" class="CodeTabs_active" role="tab" type="button">cURL</button></div><div class="CodeTabs-inner" role="tabpanel"><pre><button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang-curl theme-light" data-lang="curl" name="" tabindex="0">{ &quot;items&quot; : [ { &quot;acronyms&quot; : [], &quot;addresses&quot; : [ { &quot;city&quot; : &quot;Wellington&quot;, &quot;country_geonames_id&quot; : null, &quot;geonames_city&quot; : { &quot;city&quot; : &quot;Wellington&quot;, &quot;geonames_admin1&quot; : { &quot;ascii_name&quot; : null, &quot;code&quot; : &quot;NZ.WGN&quot;, &quot;id&quot; : null, &quot;name&quot; : &quot;Wellington Region&quot; }, &quot;geonames_admin2&quot; : { &quot;ascii_name&quot; : null, &quot;code&quot; : null, &quot;id&quot; : null, &quot;name&quot; : null }, &quot;id&quot; : 2179537, &quot;license&quot; : { &quot;attribution&quot; : &quot;Data from geonames.org under a CC-BY 3.0 license&quot;, &quot;license&quot; : &quot;http://creativecommons.org/licenses/by/3.0/&quot; }, &quot;nuts_level1&quot; : { &quot;code&quot; : null, &quot;name&quot; : null }, &quot;nuts_level2&quot; : { &quot;code&quot; : null, &quot;name&quot; : null }, &quot;nuts_level3&quot; : { &quot;code&quot; : null, &quot;name&quot; : null } }, &quot;lat&quot; : -41.28664, &quot;line&quot; : null, &quot;lng&quot; : 174.77557, &quot;postcode&quot; : null, &quot;primary&quot; : false, &quot;state&quot; : null, &quot;state_code&quot; : null } ], &quot;aliases&quot; : [ &quot;Manatū Hauora&quot; ], &quot;country&quot; : { &quot;country_code&quot; : &quot;NZ&quot;, &quot;country_name&quot; : &quot;New Zealand&quot; }, &quot;email_address&quot; : null, &quot;established&quot; : 1903, &quot;external_ids&quot; : { &quot;FundRef&quot; : { &quot;all&quot; : [ &quot;501100001504&quot; ], &quot;preferred&quot; : null }, &quot;GRID&quot; : { &quot;all&quot; : &quot;grid.415708.f&quot;, &quot;preferred&quot; : &quot;grid.415708.f&quot; }, &quot;ISNI&quot; : { &quot;all&quot; : [ &quot;0000 0004 0483 5988&quot; ], &quot;preferred&quot; : null }, &quot;Wikidata&quot; : { &quot;all&quot; : [ &quot;Q16933991&quot; ], &quot;preferred&quot; : null } }, &quot;id&quot; : &quot;https://ror.org/00vjb5165&quot;, &quot;ip_addresses&quot; : [], &quot;labels&quot; : [], &quot;links&quot; : [ &quot;http://www.health.govt.nz/&quot; ], &quot;name&quot; : &quot;Ministry of Health&quot;, &quot;relationships&quot; : [], &quot;status&quot; : &quot;active&quot;, &quot;types&quot; : [ &quot;Government&quot;, &quot;Funder&quot; ], &quot;wikipedia_url&quot; : &quot;https://en.wikipedia.org/wiki/Ministry_of_Health_(New_Zealand)&quot; } ], &quot;meta&quot; : { &quot;countries&quot; : [ { &quot;count&quot; : 1, &quot;id&quot; : &quot;nz&quot;, &quot;title&quot; : &quot;New Zealand&quot; } ], &quot;statuses&quot; : [ { &quot;count&quot; : 1, &quot;id&quot; : &quot;active&quot;, &quot;title&quot; : &quot;active&quot; } ], &quot;types&quot; : [ { &quot;count&quot; : 1, &quot;id&quot; : &quot;funder&quot;, &quot;title&quot; : &quot;Funder&quot; }, { &quot;count&quot; : 1, &quot;id&quot; : &quot;government&quot;, &quot;title&quot; : &quot;Government&quot; } ] }, &quot;number_of_results&quot; : 1, &quot;time_taken&quot; : 6 } </code></pre></div></div> <h2 class="heading heading-2 header-scroll" align=""><div class="heading-anchor anchor waypoint" id="matching-a-list-of-organization-names-to-ror-ids-using-a-script"></div><div class="heading-text"><div id="section-matching-a-list-of-organization-names-to-ror-i-ds-using-a-script" class="heading-anchor_backwardsCompatibility"></div>Matching a list of organization names to ROR IDs using a script</div><a aria-label="Skip link to Matching a list of organization names to ROR IDs using a script" class="heading-anchor-icon fa fa-anchor" href="#matching-a-list-of-organization-names-to-ror-ids-using-a-script"></a></h2> <p>You can write your own script to match a list of organization names to ROR IDs via the ROR API, though some manual intervention will likely be needed to make sure that matches are correct. If you are writing a script, remember the following:</p> <ul> <li>Try the <a href="#affiliation-parameter-approach" target="" title="">affiliation parameter approach</a> first instead of the <a href="#query-parameter-approach" target="" title="">query parameter approach</a>.</li> <li>Look for &quot;chosen&quot; results where <button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">&quot;chosen&quot;: true</code>. </li> <li>If no results are found, try alternate names/acronyms (if you have them) or try the query parameter approach. </li> <li>API results are paginated: see <a href="#api-paging" target="" title="">API paging</a> for details.</li> <li>By default, API requests will return only records with an active <a href="/docs/data-structure#status" target="" title="" class="doc-link" data-sidebar="data-structure#status">status</a>: <button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">status: &quot;active&quot;</code>. Consider whether you want to retrieve records with an inactive status as well; inactive records generally represent organizations that no longer operate. See <a href="/docs/api-filtering" target="" title="" class="doc-link" data-sidebar="api-filtering">API filtering</a> for details. </li> </ul> <p>See, use, and clone examples of Python scripts that match organization names to ROR IDs in the <a href="https://github.com/ror-community/ror-utilities" target="" title="">ror-utilities Github repository</a>.</p> <h2 class="heading heading-2 header-scroll" align=""><div class="heading-anchor anchor waypoint" id="match-organization-names-to-ror-ids-using-the-data-dump"></div><div class="heading-text"><div id="section-match-organization-names-to-ror-i-ds-using-the-data-dump" class="heading-anchor_backwardsCompatibility"></div>Match organization names to ROR IDs using the data dump</div><a aria-label="Skip link to Match organization names to ROR IDs using the data dump" class="heading-anchor-icon fa fa-anchor" href="#match-organization-names-to-ror-ids-using-the-data-dump"></a></h2> <p>Instead of using the ROR API, you can use your own scripts or processing tools on the <a href="/docs/data-dump" target="" title="" class="doc-link" data-sidebar="data-dump">ROR data dump</a> to match organization names to ROR IDs. Advantages of this approach include:</p> <ul> <li>Fine-grained control over matching criteria</li> <li>Faster processing in cases where you have many IDs to map</li> <li>No chance of error responses due to network interruptions or API outages</li> </ul> <h2 class="heading heading-2 header-scroll" align=""><div class="heading-anchor anchor waypoint" id="match-organization-names-to-ror-using-openrefine"></div><div class="heading-text"><div id="section-match-organization-names-to-ror-using-open-refine" class="heading-anchor_backwardsCompatibility"></div>Match organization names to ROR using OpenRefine</div><a aria-label="Skip link to Match organization names to ROR using OpenRefine" class="heading-anchor-icon fa fa-anchor" href="#match-organization-names-to-ror-using-openrefine"></a></h2> <p>The <strong>ROR OpenRefine Reconciler</strong> is a fairly labor-intensive way of matching organization names to ROR IDs, but it works well for those who have a relatively small list of organization names, those who want to have a high degree of control and oversight over the matching process, and those who do not want to write code. </p> <p><a href="https://openrefine.org" target="" title="">OpenRefine</a> (formerly Google Refine) is a free, open source desktop tool for cleaning up messy data stored in common formats like CSV, JSON, XML, XLS. You can even use it to connect to SQL-based databases and Google Sheets. </p> <p>See <a href="/docs/openrefine-reconciler" target="" title="" class="doc-link" data-sidebar="openrefine-reconciler">ROR OpenRefine Reconciler</a> for written usage instructions, screenshots, and a tutorial video. </p> <h2 class="heading heading-2 header-scroll" align=""><div class="heading-anchor anchor waypoint" id="match-organization-names-to-ror-ids-using-third-party-tools"></div><div class="heading-text"><div id="section-match-organization-names-to-ror-i-ds-using-third-party-tools" class="heading-anchor_backwardsCompatibility"></div>Match organization names to ROR IDs using third-party tools</div><a aria-label="Skip link to Match organization names to ROR IDs using third-party tools" class="heading-anchor-icon fa fa-anchor" href="#match-organization-names-to-ror-ids-using-third-party-tools"></a></h2> <p>Several projects and researchers have developed scripts and/or machine learning and artificial intelligence tools that match textual organization information to ROR IDs. Several of these tools are fast and can work with large amounts of data with accuracy rates before human intervention ranging from about 85% to 95%. These tools are not officially supported by ROR, but we list them here in case you find them useful. </p> <ul> <li> <p><a href="https://github.com/ourresearch/openalex-institution-parsing" target="" title="">OpenAlex Institution Parsing</a> by OurResearch</p> </li> <li> <p><a href="https://github.com/allenai/S2AFF/" target="" title="">S2AFF - Semantic Scholar Affiliations Linker</a> by the Allen AI Institute</p> </li> <li> <p><a href="https://github.com/Metadata-Game-Changers/RORRetriever" target="" title="">RORRetriever</a> by Metadata Game Changers</p> </li> <li> <p><a href="https://gitlab.ebi.ac.uk/literature-services/public-projects/ROR-proto-EMBL" target="" title="">EMBL-EBI ROR Predictor prototype</a> by EMBL-EBI for <a href="https://www.project-freya.eu/Plone/en" target="" title="">Project FREYA</a></p> </li> <li> <p><a href="https://github.com/dataesr/affiliation-matcher" target="" title="">dataESR affiliation matcher</a> developed by Anne L&#x27;Hôte and Eric Jeangirard for the French Ministry of Higher Education</p> </li> <li> <p><a href="https://github.com/adambuttrick/openalex-ror-predictor" target="" title="">OpenAlex ROR Predictor (gpu-based)</a> by ROR Curation Lead Adam Buttrick</p> </li> <li> <p><a href="https://github.com/adambuttrick/ror-predictor-fasttext" target="" title="">fastText ROR Predictor (cpu-based)</a> by ROR Curation Lead Adam Buttrick</p> </li> <li> <p><a href="https://github.com/adambuttrick/lr_matches" target="" title="">lr_predictor</a> by ROR Curation Lead Adam Buttrick</p> </li> <li> <p><a href="https://github.com/ror-community/affiliation-matching-experimental" target="" title="">ROR experimental affiliation matching</a> - A collection of data and code for training models and experimenting with automatically matching affiliation strings to ROR IDs. Not production code, and not officially supported by ROR. </p> </li> </ul> <h2 class="heading heading-2 header-scroll" align=""><div class="heading-anchor anchor waypoint" id="testing-and-training-data"></div><div class="heading-text"><div id="section-testing-and-training-data" class="heading-anchor_backwardsCompatibility"></div>Testing and training data</div><a aria-label="Skip link to Testing and training data" class="heading-anchor-icon fa fa-anchor" href="#testing-and-training-data"></a></h2> <p>ROR is currently experimenting with strategies for automatically matching affiliation strings to ROR IDs, and we have collected sets of data from Springer Nature, the American Physical Society, Crossref, and OpenAlex for testing and training matching strategies that are openly available at <a href="https://github.com/ror-community/affiliation-matching-experimental/tree/main/test_data" target="" title="">https://github.com/ror-community/affiliation-matching-experimental/tree/main/test_data</a>. These datasets include affiliation text strings from production systems that have been matched to ROR IDs with varying levels of human review.</p>" style="margin-left:31px" class="rm-Markdown markdown-body rm-Markdown markdown-body ng-non-bindable" data-testid="RDMD"><p>If you have organization names or full affiliation strings stored in your system as text, there are several approaches to matching those text strings to ROR IDs. </p> <p>The approaches given below are for cases when you have a list, a spreadsheet, or a database with organization information as text strings, often with "extra" text such as a department or address as well as the organization's name, but no corresponding organization IDs. </p> <p>Examples of organization names and affiliation information as text strings and the corresponding ROR ID: </p> <ul> <li>University of Haifa > <a target="_self" href="https://ror.org/02f009v59">https://ror.org/02f009v59</a> </li> <li>University of ManchesterGreater Manchester Mental Health NHS Foundation TrustNational Institute for Health Research (NIHR) Greater Manchester Patient Safety Translational Research Centre > <a target="_self" href="https://ror.org/05sb89p83">https://ror.org/05sb89p83</a> </li> <li>Atmospheric Sciences and Global Change Division, Pacific Northwest National Laboratory, Richland, WA, USA > <a target="_self" href="https://ror.org/05h992307">https://ror.org/05h992307</a> </li> </ul> <blockquote class="callout callout_info" theme="📘"><h2 class="callout-heading"><span class="callout-icon">📘</span><p>Mapping names and IDs to ROR</p></h2><p>If you have organization names along with another global organization ID (Crossref Funder ID, GRID, ISNI, or Wikidata), you may find quicker, more accurate results by mapping those other IDs to ROR. See <a target="_self" href="/docs/mapping">Map other organization ID types to ROR</a>. </p><p>If you need to match ROR IDs to user input in a web application, see <a target="_self" href="/docs/forms">Create ROR-powered typeaheads in forms</a>.</p></blockquote> <h2 class="heading heading-2 header-scroll" align=""><div class="heading-anchor anchor waypoint" id="match-organization-names-to-ror-ids-using-the-ror-api"></div><div class="heading-text"><div id="section-match-organization-names-to-ror-i-ds-using-the-ror-api" class="heading-anchor_backwardsCompatibility"></div>Match organization names to ROR IDs using the ROR API</div><a aria-label="Skip link to Match organization names to ROR IDs using the ROR API" class="heading-anchor-icon fa fa-anchor" href="#match-organization-names-to-ror-ids-using-the-ror-api"></a></h2> <h3 class="heading heading-3 header-scroll" align=""><div class="heading-anchor anchor waypoint" id="query-vs-affiliation-parameter"></div><div class="heading-text"><div id="section-query-vs-affiliation-parameter" class="heading-anchor_backwardsCompatibility"></div>Query vs affiliation parameter</div><a aria-label="Skip link to Query vs affiliation parameter" class="heading-anchor-icon fa fa-anchor" href="#query-vs-affiliation-parameter"></a></h3> <p>The <a target="_self" href="/docs/api-about">ROR API</a> offers 2 ways to search ROR records, which work slightly differently and return different results:</p> <ul> <li> <p><strong><a target="_self" href="#affiliation-parameter-approach">Affiliation parameter</a></strong> <button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">/organizations?affiliation=</code>: Searches <button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">name</code>, <button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">aliases</code>, and <button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">labels</code> fields using different search algorithms and returns the best match(es) based on matching score. Includes matching score and true/false indicator of whether the score is high enough to be considered a reliable match. Produces about 85% correct matches in our tests; individual implementations may see better or worse results. </p> </li> <li> <p><strong><a target="_self" href="#query-parameter-approach">Query parameter</a></strong> <button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">/organizations?query=</code>: Searches <button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">name</code>, <button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">aliases</code>, <button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">labels</code>, <button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">acronyms</code>, and <button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">external_ids</code> fields in ROR records and returns all matching records. Does NOT include a matching score or true/false indicator of whether the score is high enough to be considered a reliable match.</p> </li> </ul> <p>For cases where you have relatively unique organization names or full affiliation strings, use the <a target="_self" href="#affiliation-parameter-approach">affiliation parameter approach</a>. Works for both English and non-English name variations. Examples:</p> <ul> <li>Incorporated Research Institutions for Seismology (IRIS)</li> <li>Universitätsbibliothek der Ludwig-Maximilians-Universität München</li> <li>Department of Civil and Industrial Engineering, University of Pisa, Largo Lucio Lazzarino 2, Pisa 56126, Italy</li> </ul> <p>For cases where you have very common organization names, use the <a target="_self" href="#query-parameter-approach">query parameter approach</a> to look for keywords from the organization's name or the exact name of the organization surrounded by double quotation marks, and consider using filters for organization type and country. Examples:</p> <ul> <li>Ministry of Health</li> <li>National Research Council</li> <li>York University</li> </ul> <blockquote class="callout callout_info" theme="📘"><h2 class="callout-heading"><span class="callout-icon">📘</span><p>Retrieving active and inactive organizations</p></h2><p>By default, both the affiliation parameter and the query parameter will return only records with an active <a target="_self" href="/docs/data-structure#status">status</a>: <button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">status: "active"</code>. Consider whether you also want to retrieve records with an inactive status; inactive records generally represent organizations that no longer operate. See <a target="_self" href="/docs/api-filtering">API filtering</a> for details. </p><p>Be aware too that inactive organizations may be succeeded by a new organization under a different name with a different ROR ID. If you do retrieve inactive organizations, check the <button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">relationships</code> field of an inactive record to see if it has a <a target="_self" href="/docs/data-structure#relationships">Successor organization</a>.</p></blockquote> <h3 class="heading heading-3 header-scroll" align=""><div class="heading-anchor anchor waypoint" id="affiliation-parameter-approach"></div><div class="heading-text"><div id="section-affiliation-parameter-approach" class="heading-anchor_backwardsCompatibility"></div>Affiliation parameter approach</div><a aria-label="Skip link to Affiliation parameter approach" class="heading-anchor-icon fa fa-anchor" href="#affiliation-parameter-approach"></a></h3> <p>Searches <button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">name</code>, <button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">aliases</code> and <button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">labels</code> fields using different search algorithms and returns the best match(es) based on matching score using the format <button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">https://api.ror.org/organizations?affiliation=<URL-encoded string></code>. For the full list of fields returned, see <a target="_self" href="/docs/fields">Fields and sub-fields</a>.</p> <div class="CodeTabs CodeTabs_initial theme-light"><div class="CodeTabs-toolbar" role="tablist"><button aria-selected="true" class="CodeTabs_active" role="tab" type="button">cURL</button></div><div class="CodeTabs-inner" role="tabpanel"><pre><button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang-curl theme-light" data-lang="curl" name="" tabindex="0">curl 'https://api.ror.org/v1/organizations?affiliation=university+of+wisconsin+madison' | json_pp </code></pre></div></div> <p>If there's a high-confidence match, it will appear as the first result, with <button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">"chosen": true</code>. Other results and their matching score will also be returned, but if you're automating this process using a script, we recommend using results with <button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">"chosen": true</code> rather than relying on the score. Results are paginated: see <a target="_self" href="/docs/api-paging">API paging</a> for details.</p> <div class="CodeTabs CodeTabs_initial theme-light"><div class="CodeTabs-toolbar" role="tablist"><button aria-selected="true" class="CodeTabs_active" role="tab" type="button">JSON</button></div><div class="CodeTabs-inner" role="tabpanel"><pre><button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang-json theme-light" data-lang="json" name="" tabindex="0">{ "items" : [ { "chosen" : true, "matching_type" : "EXACT", "organization" : { "acronyms" : [ "UW" ], "addresses" : [ { "city" : "Madison", "country_geonames_id" : null, "geonames_city" : { "city" : "Madison", "geonames_admin1" : { "ascii_name" : null, "code" : "US.WI", "id" : null, "name" : "Wisconsin" }, "geonames_admin2" : { "ascii_name" : null, "code" : null, "id" : null, "name" : null }, "id" : 5261457, "license" : { "attribution" : "Data from geonames.org under a CC-BY 3.0 license", "license" : "http://creativecommons.org/licenses/by/3.0/" }, "nuts_level1" : { "code" : null, "name" : null }, "nuts_level2" : { "code" : null, "name" : null }, "nuts_level3" : { "code" : null, "name" : null } }, "lat" : 43.07305, "line" : null, "lng" : -89.40123, "postcode" : null, "primary" : false, "state" : null, "state_code" : null } ], "aliases" : [ "UW–Madison" ], "country" : { "country_code" : "US", "country_name" : "United States" }, "email_address" : null, "established" : 1848, "external_ids" : { "FundRef" : { "all" : [ "100007015", "100008959", "100005996", "100007870", "100008301", "100008028", "100008237", "100008161", "100010495", "100009627", "100010284", "100005911", "100007925", "100005902", "100012787" ], "preferred" : "100007015" }, "GRID" : { "all" : "grid.14003.36", "preferred" : "grid.14003.36" }, "ISNI" : { "all" : [ "0000 0001 2167 3675" ], "preferred" : null }, "Wikidata" : { "all" : [ "Q838330", "Q33122195", "Q7662222" ], "preferred" : "Q838330" } }, "id" : "https://ror.org/01y2jtd41", "ip_addresses" : [], "labels" : [ { "iso639" : "es", "label" : "Universidad de Wisconsin-Madison" }, { "iso639" : "fr", "label" : "Université du Wisconsin à Madison" } ], "links" : [ "http://www.wisc.edu/" ], "name" : "University of Wisconsin–Madison", "relationships" : [ { "id" : "https://ror.org/05cb4rb43", "label" : "Morgridge Institute for Research", "type" : "Child" }, { "id" : "https://ror.org/04gq8q482", "label" : "North Temperate Lakes Long Term Ecological Research", "type" : "Child" }, { "id" : "https://ror.org/03ydkyb10", "label" : "University of Wisconsin System", "type" : "Parent" }, { "id" : "https://ror.org/03b8vas82", "label" : "National Atmospheric Deposition Program", "type" : "Related" }, { "id" : "https://ror.org/04r3s7465", "label" : "McMurdo Dry Valleys Long Term Ecological Research", "type" : "Related" }, { "id" : "https://ror.org/02kj3rm24", "label" : "Wisconsin Geological and Natural History Survey", "type" : "Child" } ], "status" : "active", "types" : [ "Education", "Funder" ], "wikipedia_url" : "http://en.wikipedia.org/wiki/University_of_Wisconsin%E2%80%93Madison" }, "score" : 1, "substring" : "university of wisconsin madison" }, { "chosen" : false, "matching_type" : "EXACT", "organization" : { "acronyms" : [ "UWHC" ], "addresses" : [ { "city" : "Madison", "country_geonames_id" : null, "geonames_city" : { "city" : "Madison", "geonames_admin1" : { "ascii_name" : null, "code" : "US.WI", "id" : null, "name" : "Wisconsin" }, "geonames_admin2" : { "ascii_name" : null, "code" : null, "id" : null, "name" : null }, "id" : 5261457, "license" : { "attribution" : "Data from geonames.org under a CC-BY 3.0 license", "license" : "http://creativecommons.org/licenses/by/3.0/" }, "nuts_level1" : { "code" : null, "name" : null }, "nuts_level2" : { "code" : null, "name" : null }, "nuts_level3" : { "code" : null, "name" : null } }, "lat" : 43.07305, "line" : null, "lng" : -89.40123, "postcode" : null, "primary" : false, "state" : null, "state_code" : null } ], "aliases" : [ "UW Hospital and Clinics", "University of Wisconsin Health University Hospital", "University of Wisconsin Hospital and Clinics", "University of Wisconsin-Madison Hospital", "Wisconsin General Hospital" ], "country" : { "country_code" : "US", "country_name" : "United States" }, "email_address" : null, "established" : 1924, "external_ids" : { "GRID" : { "all" : "grid.412647.2", "preferred" : "grid.412647.2" }, "ISNI" : { "all" : [ "0000 0000 9209 0955" ], "preferred" : null }, "Wikidata" : { "all" : [ "Q7896631" ], "preferred" : null } }, "id" : "https://ror.org/02mqqhj42", "ip_addresses" : [], "labels" : [], "links" : [ "https://www.uwhealth.org/locations/university-hospital-170" ], "name" : "UW Health University Hospital", "relationships" : [ { "id" : "https://ror.org/01e4byj08", "label" : "University of Wisconsin Carbone Cancer Center", "type" : "Child" }, { "id" : "https://ror.org/03e3qgk42", "label" : "University of Wisconsin Health", "type" : "Parent" } ], "status" : "active", "types" : [ "Healthcare" ], "wikipedia_url" : "https://en.wikipedia.org/wiki/University_of_Wisconsin_Hospital_and_Clinics" }, "score" : 0.87, "substring" : "university of wisconsin madison" }, { "chosen" : false, "matching_type" : "EXACT", "organization" : { "acronyms" : [ "UWCCC" ], "addresses" : [ { "city" : "Madison", "country_geonames_id" : null, "geonames_city" : { "city" : "Madison", "geonames_admin1" : { "ascii_name" : null, "code" : "US.WI", "id" : null, "name" : "Wisconsin" }, "geonames_admin2" : { "ascii_name" : null, "code" : null, "id" : null, "name" : null }, "id" : 5261457, "license" : { "attribution" : "Data from geonames.org under a CC-BY 3.0 license", "license" : "http://creativecommons.org/licenses/by/3.0/" }, "nuts_level1" : { "code" : null, "name" : null }, "nuts_level2" : { "code" : null, "name" : null }, "nuts_level3" : { "code" : null, "name" : null } }, "lat" : 43.07305, "line" : null, "lng" : -89.40123, "postcode" : null, "primary" : false, "state" : null, "state_code" : null } ], "aliases" : [ "Carbone Cancer Center", "UW Carbone", "UW Carbone Cancer Center", "UW Carbone Comprehensive Cancer Center", "UWCCC Madison", "University of Wisconsin Cancer Center", "University of Wisconsin Carbone Comprehensive Cancer Center", "University of Wisconsin Comprehensive Cancer Center", "University of Wisconsin-Madison Carbone Cancer Center" ], "country" : { "country_code" : "US", "country_name" : "United States" }, "email_address" : null, "established" : 1940, "external_ids" : { "FundRef" : { "all" : [ "100007923" ], "preferred" : "100007923" }, "GRID" : { "all" : "grid.412639.b", "preferred" : "grid.412639.b" }, "ISNI" : { "all" : [ "0000 0001 2191 1477" ], "preferred" : null }, "Wikidata" : { "all" : [ "Q7876154" ], "preferred" : null } }, "id" : "https://ror.org/01e4byj08", "ip_addresses" : [], "labels" : [], "links" : [ "https://cancer.wisc.edu" ], "name" : "University of Wisconsin Carbone Cancer Center", "relationships" : [ { "id" : "https://ror.org/02mqqhj42", "label" : "UW Health University Hospital", "type" : "Parent" } ], "status" : "active", "types" : [ "Funder", "Healthcare" ], "wikipedia_url" : "https://en.wikipedia.org/wiki/University_of_Wisconsin_Carbone_Cancer_Center" }, "score" : 0.76, "substring" : "university of wisconsin madison" } ], "number_of_results" : 3 } </code></pre></div></div> <blockquote class="callout callout_warn" theme="🚧"><h2 class="callout-heading"><span class="callout-icon">🚧</span><p>Don't automatically select the first "unchosen" result of an ?affiliation query with no <button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">chosen: true</code> result</p></h2><p>When no result has <button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">"chosen": true</code>, the first result is not necessarily the best match for a given affiliation string. In that case, several results may have the exact same score and/or there may be no match with a high score. Because the affiliation service breaks a given affiliation string into multiple substrings and performs searches of each substring on its own as well as in combination with other substrings, a high scoring match that is not selected as chosen may be a match to only a small portion of the entire affiliation string. In these cases, it is best to respect the absence of <button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">"chosen: true"</code> and leave the string unmatched or add a layer of human or machine assignment, at your discretion.</p></blockquote> <h4 class="heading heading-4 header-scroll" align=""><div class="heading-anchor anchor waypoint" id="additional-request-examples"></div><div class="heading-text"><div id="section-additional-request-examples" class="heading-anchor_backwardsCompatibility"></div>Additional request examples:</div><a aria-label="Skip link to Additional request examples:" class="heading-anchor-icon fa fa-anchor" href="#additional-request-examples"></a></h4> <p>Incorporated Research Institutions for Seismology (IRIS)</p> <div class="CodeTabs CodeTabs_initial theme-light"><div class="CodeTabs-toolbar" role="tablist"><button aria-selected="true" class="CodeTabs_active" role="tab" type="button">cURL</button></div><div class="CodeTabs-inner" role="tabpanel"><pre><button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang-curl theme-light" data-lang="curl" name="" tabindex="0">curl 'https://api.ror.org/v1/organizations?affiliation=Incorporated%20Research%20Institutions%20for%20Seismology%20(IRIS)' | json_pp </code></pre></div></div> <p>Universitätsbibliothek der Ludwig-Maximilians-Universität München</p> <div class="CodeTabs CodeTabs_initial theme-light"><div class="CodeTabs-toolbar" role="tablist"><button aria-selected="true" class="CodeTabs_active" role="tab" type="button">cURL</button></div><div class="CodeTabs-inner" role="tabpanel"><pre><button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang-curl theme-light" data-lang="curl" name="" tabindex="0">curl 'https://api.ror.org/v1/organizations?affiliation=Universit%C3%A4tsbibliothek%20der%20Ludwig-Maximilians-Universit%C3%A4t%20M%C3%BCnchen' | json_pp </code></pre></div></div> <p>Department of Civil and Industrial Engineering, University of Pisa, Largo Lucio Lazzarino 2, Pisa 56126, Italy</p> <div class="CodeTabs CodeTabs_initial theme-light"><div class="CodeTabs-toolbar" role="tablist"><button aria-selected="true" class="CodeTabs_active" role="tab" type="button">cURL</button></div><div class="CodeTabs-inner" role="tabpanel"><pre><button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang-curl theme-light" data-lang="curl" name="" tabindex="0">curl 'https://api.ror.org/v1/organizations?affiliation=Department%20of%20Civil%20and%20Industrial%20Engineering%2C%20University%20of%20Pisa%2C%20Largo%20Lucio%20Lazzarino%202%2C%20Pisa%2056126%2C%20Italy' | json_pp </code></pre></div></div> <h3 class="heading heading-3 header-scroll" align=""><div class="heading-anchor anchor waypoint" id="query-parameter-approach"></div><div class="heading-text"><div id="section-query-parameter-approach" class="heading-anchor_backwardsCompatibility"></div>Query parameter approach</div><a aria-label="Skip link to Query parameter approach" class="heading-anchor-icon fa fa-anchor" href="#query-parameter-approach"></a></h3> <p>Search all indexed fields in ROR records using the format <button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">https://api.ror.org/organizations?query=<search term>&filter=<filters></code>. We strongly recommend using <a target="_self" href="/docs/filtering">organization type and country filters</a>. For more information, see the <a target="_self" href="/docs/rest-api">REST API guide</a>.</p> <div class="CodeTabs CodeTabs_initial theme-light"><div class="CodeTabs-toolbar" role="tablist"><button aria-selected="true" class="CodeTabs_active" role="tab" type="button">cURL</button></div><div class="CodeTabs-inner" role="tabpanel"><pre><button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang-curl theme-light" data-lang="curl" name="" tabindex="0">curl 'https://api.ror.org/v1/organizations?query=%22Ministry+of+Health%22&filter=types:Government,country.country_code:NZ' | json_pp </code></pre></div></div> <p>The response is a JSON object containing full records for the first 20 search results. Results are paginated: see <a target="_self" href="/docs/api-paging">API paging</a> for details. Matching scores are not included, but closest matches are at the beginning of the list. </p> <blockquote class="callout callout_info" theme="📘"><h2 class="callout-heading"><span class="callout-icon">📘</span><p>Query parameter searches may return many results, so some amount of human intervention may be needed to determine the matching ROR ID (if there is one).</p></h2></blockquote> <div class="CodeTabs CodeTabs_initial theme-light"><div class="CodeTabs-toolbar" role="tablist"><button aria-selected="true" class="CodeTabs_active" role="tab" type="button">cURL</button></div><div class="CodeTabs-inner" role="tabpanel"><pre><button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang-curl theme-light" data-lang="curl" name="" tabindex="0">{ "items" : [ { "acronyms" : [], "addresses" : [ { "city" : "Wellington", "country_geonames_id" : null, "geonames_city" : { "city" : "Wellington", "geonames_admin1" : { "ascii_name" : null, "code" : "NZ.WGN", "id" : null, "name" : "Wellington Region" }, "geonames_admin2" : { "ascii_name" : null, "code" : null, "id" : null, "name" : null }, "id" : 2179537, "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" : -41.28664, "line" : null, "lng" : 174.77557, "postcode" : null, "primary" : false, "state" : null, "state_code" : null } ], "aliases" : [ "Manatū Hauora" ], "country" : { "country_code" : "NZ", "country_name" : "New Zealand" }, "email_address" : null, "established" : 1903, "external_ids" : { "FundRef" : { "all" : [ "501100001504" ], "preferred" : null }, "GRID" : { "all" : "grid.415708.f", "preferred" : "grid.415708.f" }, "ISNI" : { "all" : [ "0000 0004 0483 5988" ], "preferred" : null }, "Wikidata" : { "all" : [ "Q16933991" ], "preferred" : null } }, "id" : "https://ror.org/00vjb5165", "ip_addresses" : [], "labels" : [], "links" : [ "http://www.health.govt.nz/" ], "name" : "Ministry of Health", "relationships" : [], "status" : "active", "types" : [ "Government", "Funder" ], "wikipedia_url" : "https://en.wikipedia.org/wiki/Ministry_of_Health_(New_Zealand)" } ], "meta" : { "countries" : [ { "count" : 1, "id" : "nz", "title" : "New Zealand" } ], "statuses" : [ { "count" : 1, "id" : "active", "title" : "active" } ], "types" : [ { "count" : 1, "id" : "funder", "title" : "Funder" }, { "count" : 1, "id" : "government", "title" : "Government" } ] }, "number_of_results" : 1, "time_taken" : 6 } </code></pre></div></div> <h2 class="heading heading-2 header-scroll" align=""><div class="heading-anchor anchor waypoint" id="matching-a-list-of-organization-names-to-ror-ids-using-a-script"></div><div class="heading-text"><div id="section-matching-a-list-of-organization-names-to-ror-i-ds-using-a-script" class="heading-anchor_backwardsCompatibility"></div>Matching a list of organization names to ROR IDs using a script</div><a aria-label="Skip link to Matching a list of organization names to ROR IDs using a script" class="heading-anchor-icon fa fa-anchor" href="#matching-a-list-of-organization-names-to-ror-ids-using-a-script"></a></h2> <p>You can write your own script to match a list of organization names to ROR IDs via the ROR API, though some manual intervention will likely be needed to make sure that matches are correct. If you are writing a script, remember the following:</p> <ul> <li>Try the <a target="_self" href="#affiliation-parameter-approach">affiliation parameter approach</a> first instead of the <a target="_self" href="#query-parameter-approach">query parameter approach</a>.</li> <li>Look for "chosen" results where <button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">"chosen": true</code>. </li> <li>If no results are found, try alternate names/acronyms (if you have them) or try the query parameter approach. </li> <li>API results are paginated: see <a target="_self" href="#api-paging">API paging</a> for details.</li> <li>By default, API requests will return only records with an active <a target="_self" href="/docs/data-structure#status">status</a>: <button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">status: "active"</code>. Consider whether you want to retrieve records with an inactive status as well; inactive records generally represent organizations that no longer operate. See <a target="_self" href="/docs/api-filtering">API filtering</a> for details. </li> </ul> <p>See, use, and clone examples of Python scripts that match organization names to ROR IDs in the <a target="_self" href="https://github.com/ror-community/ror-utilities">ror-utilities Github repository</a>.</p> <h2 class="heading heading-2 header-scroll" align=""><div class="heading-anchor anchor waypoint" id="match-organization-names-to-ror-ids-using-the-data-dump"></div><div class="heading-text"><div id="section-match-organization-names-to-ror-i-ds-using-the-data-dump" class="heading-anchor_backwardsCompatibility"></div>Match organization names to ROR IDs using the data dump</div><a aria-label="Skip link to Match organization names to ROR IDs using the data dump" class="heading-anchor-icon fa fa-anchor" href="#match-organization-names-to-ror-ids-using-the-data-dump"></a></h2> <p>Instead of using the ROR API, you can use your own scripts or processing tools on the <a target="_self" href="/docs/data-dump">ROR data dump</a> to match organization names to ROR IDs. Advantages of this approach include:</p> <ul> <li>Fine-grained control over matching criteria</li> <li>Faster processing in cases where you have many IDs to map</li> <li>No chance of error responses due to network interruptions or API outages</li> </ul> <h2 class="heading heading-2 header-scroll" align=""><div class="heading-anchor anchor waypoint" id="match-organization-names-to-ror-using-openrefine"></div><div class="heading-text"><div id="section-match-organization-names-to-ror-using-open-refine" class="heading-anchor_backwardsCompatibility"></div>Match organization names to ROR using OpenRefine</div><a aria-label="Skip link to Match organization names to ROR using OpenRefine" class="heading-anchor-icon fa fa-anchor" href="#match-organization-names-to-ror-using-openrefine"></a></h2> <p>The <strong>ROR OpenRefine Reconciler</strong> is a fairly labor-intensive way of matching organization names to ROR IDs, but it works well for those who have a relatively small list of organization names, those who want to have a high degree of control and oversight over the matching process, and those who do not want to write code. </p> <p><a target="_self" href="https://openrefine.org">OpenRefine</a> (formerly Google Refine) is a free, open source desktop tool for cleaning up messy data stored in common formats like CSV, JSON, XML, XLS. You can even use it to connect to SQL-based databases and Google Sheets. </p> <p>See <a target="_self" href="/docs/openrefine-reconciler">ROR OpenRefine Reconciler</a> for written usage instructions, screenshots, and a tutorial video. </p> <h2 class="heading heading-2 header-scroll" align=""><div class="heading-anchor anchor waypoint" id="match-organization-names-to-ror-ids-using-third-party-tools"></div><div class="heading-text"><div id="section-match-organization-names-to-ror-i-ds-using-third-party-tools" class="heading-anchor_backwardsCompatibility"></div>Match organization names to ROR IDs using third-party tools</div><a aria-label="Skip link to Match organization names to ROR IDs using third-party tools" class="heading-anchor-icon fa fa-anchor" href="#match-organization-names-to-ror-ids-using-third-party-tools"></a></h2> <p>Several projects and researchers have developed scripts and/or machine learning and artificial intelligence tools that match textual organization information to ROR IDs. Several of these tools are fast and can work with large amounts of data with accuracy rates before human intervention ranging from about 85% to 95%. These tools are not officially supported by ROR, but we list them here in case you find them useful. </p> <ul> <li> <p><a target="_self" href="https://github.com/ourresearch/openalex-institution-parsing">OpenAlex Institution Parsing</a> by OurResearch</p> </li> <li> <p><a target="_self" href="https://github.com/allenai/S2AFF/">S2AFF - Semantic Scholar Affiliations Linker</a> by the Allen AI Institute</p> </li> <li> <p><a target="_self" href="https://github.com/Metadata-Game-Changers/RORRetriever">RORRetriever</a> by Metadata Game Changers</p> </li> <li> <p><a target="_self" href="https://gitlab.ebi.ac.uk/literature-services/public-projects/ROR-proto-EMBL">EMBL-EBI ROR Predictor prototype</a> by EMBL-EBI for <a target="_self" href="https://www.project-freya.eu/Plone/en">Project FREYA</a></p> </li> <li> <p><a target="_self" href="https://github.com/dataesr/affiliation-matcher">dataESR affiliation matcher</a> developed by Anne L'Hôte and Eric Jeangirard for the French Ministry of Higher Education</p> </li> <li> <p><a target="_self" href="https://github.com/adambuttrick/openalex-ror-predictor">OpenAlex ROR Predictor (gpu-based)</a> by ROR Curation Lead Adam Buttrick</p> </li> <li> <p><a target="_self" href="https://github.com/adambuttrick/ror-predictor-fasttext">fastText ROR Predictor (cpu-based)</a> by ROR Curation Lead Adam Buttrick</p> </li> <li> <p><a target="_self" href="https://github.com/adambuttrick/lr_matches">lr_predictor</a> by ROR Curation Lead Adam Buttrick</p> </li> <li> <p><a target="_self" href="https://github.com/ror-community/affiliation-matching-experimental">ROR experimental affiliation matching</a> - A collection of data and code for training models and experimenting with automatically matching affiliation strings to ROR IDs. Not production code, and not officially supported by ROR. </p> </li> </ul> <h2 class="heading heading-2 header-scroll" align=""><div class="heading-anchor anchor waypoint" id="testing-and-training-data"></div><div class="heading-text"><div id="section-testing-and-training-data" class="heading-anchor_backwardsCompatibility"></div>Testing and training data</div><a aria-label="Skip link to Testing and training data" class="heading-anchor-icon fa fa-anchor" href="#testing-and-training-data"></a></h2> <p>ROR is currently experimenting with strategies for automatically matching affiliation strings to ROR IDs, and we have collected sets of data from Springer Nature, the American Physical Society, Crossref, and OpenAlex for testing and training matching strategies that are openly available at <a target="_self" href="https://github.com/ror-community/affiliation-matching-experimental/tree/main/test_data">https://github.com/ror-community/affiliation-matching-experimental/tree/main/test_data</a>. These datasets include affiliation text strings from production systems that have been matched to ROR IDs with varying levels of human review.</p></div><div class="UpdatedAt"><p class="DateLine "><i class="icon icon-watch"></i>Updated 2 months ago </p></div><hr class="NextStepsDivider"/><div class="WhatsNext-wrapper3DTnpcPqKoHg"><header class="APISectionHeader3LN_-QIR0m7x rm-APISectionHeader WhatsNext-headingQHN33r4trf_s"><div class="APISectionHeader-heading4MUMLbp4_nLs">Other resources you might find helpful</div></header><div class="rm-Markdown markdown-body WhatsNext-description1zZyZLPCGmaa WhatsNext-description_empty1Hh8M1AKGhbW" data-testid="RDMD"></div><ul><li><a class="WhatsNext-link" target="_self" href="/docs/openrefine-reconciler">OpenRefine reconciler</a><span class="IconWrapper Icon-wrapper2z2wVIeGsiUy"><svg fill="none" viewBox="0 0 24 24" class="Icon Icon3_D2ysxFZ_ll Icon-svg2Lm7f6G9Ly5a icon" data-name="arrow-right" role="img" style="--icon-color:inherit;--icon-size:inherit;--icon-stroke-width:2px" aria-hidden="true"><path stroke="currentColor" stroke-linecap="round" stroke-linejoin="round" d="M5 12h14M12 5l7 7-7 7" class="icon-stroke-width"></path></svg></span></li><li><a class="WhatsNext-link" href="https://youtu.be/Tx5y7lX030U" target="blank">Video: Strategies for Matching Affiliation Strings to ROR IDs</a><span class="IconWrapper Icon-wrapper2z2wVIeGsiUy"><svg fill="none" viewBox="0 0 24 24" class="Icon Icon3_D2ysxFZ_ll Icon-svg2Lm7f6G9Ly5a icon" data-name="arrow-up-right" role="img" style="--icon-color:inherit;--icon-size:inherit;--icon-stroke-width:2px" aria-hidden="true"><path stroke="currentColor" stroke-linecap="round" stroke-linejoin="round" d="M7 17 17 7M7 7h10v10" class="icon-stroke-width"></path></svg></span></li><li><a class="WhatsNext-link" href="https://www.youtube.com/watch?v=MzfeUJwtDBg" target="blank">Video: Smart matching enabled by the ROR API for the OA Switchboard</a><span class="IconWrapper Icon-wrapper2z2wVIeGsiUy"><svg fill="none" viewBox="0 0 24 24" class="Icon Icon3_D2ysxFZ_ll Icon-svg2Lm7f6G9Ly5a icon" data-name="arrow-up-right" role="img" style="--icon-color:inherit;--icon-size:inherit;--icon-stroke-width:2px" aria-hidden="true"><path stroke="currentColor" stroke-linecap="round" stroke-linejoin="round" d="M7 17 17 7M7 7h10v10" class="icon-stroke-width"></path></svg></span></li><li><a class="WhatsNext-link" href="https://github.com/ror-community/ror-utilities" target="blank">ror-utilities matching and mapping scripts</a><span class="IconWrapper Icon-wrapper2z2wVIeGsiUy"><svg fill="none" viewBox="0 0 24 24" class="Icon Icon3_D2ysxFZ_ll Icon-svg2Lm7f6G9Ly5a icon" data-name="arrow-up-right" role="img" style="--icon-color:inherit;--icon-size:inherit;--icon-stroke-width:2px" aria-hidden="true"><path stroke="currentColor" stroke-linecap="round" stroke-linejoin="round" d="M7 17 17 7M7 7h10v10" class="icon-stroke-width"></path></svg></span></li></ul></div></section><section class="content-toc grid-25"><nav><ul class="toc-list"><li><a class="tocHeader" href="#"><i class="icon icon-text-align-left"></i>Table of Contents</a></li><li class="toc-children"><ul> <li> <a href="#match-organization-names-to-ror-ids-using-the-ror-api">Match organization names to ROR IDs using the ROR API</a> <ul> <li><a href="#query-vs-affiliation-parameter">Query vs affiliation parameter</a></li> <li><a href="#affiliation-parameter-approach">Affiliation parameter approach</a></li> <li><a href="#query-parameter-approach">Query parameter approach</a></li> </ul> </li> <li> <a href="#matching-a-list-of-organization-names-to-ror-ids-using-a-script">Matching a list of organization names to ROR IDs using a script</a> </li> <li> <a href="#match-organization-names-to-ror-ids-using-the-data-dump">Match organization names to ROR IDs using the data dump</a> </li> <li> <a href="#match-organization-names-to-ror-using-openrefine">Match organization names to ROR using OpenRefine</a> </li> <li> <a href="#match-organization-names-to-ror-ids-using-third-party-tools">Match organization names to ROR IDs using third-party tools</a> </li> <li> <a href="#testing-and-training-data">Testing and training data</a> </li> </ul></li></ul></nav></section></div><div class="ModalWrapper" id="tutorialmodal-root"></div></article></div></main><footer aria-label="Status banner" class="AppFooter rm-Banners"></footer><div class="ModalWrapper" id="ChatGPT-modal"></div></div></div><div class="ng-non-bindable"><script id="ssr-props" data-initial-props="{"sidebars":{"docs":[{"_id":"60d25b23765a5900437c8fce","title":"Getting Started with ROR","slug":"getting-started","order":1,"reference":false,"isAPI":false,"project":"6058e47681775f002de04832","version":"6058e47681775f002de04837","createdAt":"2021-06-22T21:50:27.898Z","__v":0,"pages":[{"_id":"60d25d491c90f40053e991e0","api":{"method":"get","url":"","auth":"required","results":{"codes":[{"name":"","code":"{}","language":"json","status":200},{"name":"","code":"{}","language":"json","status":400}]},"params":[]},"title":"ROR basics","type":"basic","slug":"basics","order":0,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"ror-basics","createdAt":"2021-06-22T21:59:37.805Z","category":"60d25b23765a5900437c8fce","parentDoc":null,"deprecated":false,"icon":"","mdx":{},"isBodyEmpty":false,"children":[]},{"_id":"62fb961f8d112700211bbf15","api":{"method":"get","url":"","auth":"required","results":{"codes":[{"name":"","code":"{}","language":"json","status":200},{"name":"","code":"{}","language":"json","status":400}]},"params":[],"examples":{"codes":[]}},"title":"Identifier pattern","icon":"","type":"basic","slug":"identifier","order":1,"isReference":false,"deprecated":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"ror-identifier-pattern","createdAt":"2022-08-16T13:05:35.053Z","category":"60d25b23765a5900437c8fce","parentDoc":null,"isBodyEmpty":false,"children":[]},{"_id":"630d0205f1b18c003de1d215","api":{"method":"get","url":"","auth":"required","results":{"codes":[{"name":"","code":"{}","language":"json","status":200},{"name":"","code":"{}","language":"json","status":400}]},"params":[],"examples":{"codes":[]}},"title":"Logos and display guidelines","icon":"","type":"basic","slug":"display","order":2,"isReference":false,"deprecated":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"ror-id-display-guidelines-and-logos","createdAt":"2022-08-29T18:14:29.139Z","category":"60d25b23765a5900437c8fce","parentDoc":null,"mdx":{},"isBodyEmpty":false,"children":[]},{"_id":"60f8832f8d0c540065cf57a6","api":{"method":"get","url":"","auth":"required","results":{"codes":[{"name":"","code":"{}","language":"json","status":200},{"name":"","code":"{}","language":"json","status":400}]},"params":[],"examples":{"codes":[]}},"title":"See who uses ROR","type":"basic","slug":"integrations","order":3,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"ror-integrations","createdAt":"2021-07-21T20:27:27.858Z","category":"60d25b23765a5900437c8fce","parentDoc":null,"deprecated":false,"icon":"","isBodyEmpty":false,"children":[]},{"_id":"60f88138b824e4001ccd7e71","api":{"method":"get","url":"","auth":"required","results":{"codes":[{"name":"","code":"{}","language":"json","status":200},{"name":"","code":"{}","language":"json","status":400}]},"params":[]},"title":"Get involved","type":"basic","slug":"get-involved","order":4,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"","createdAt":"2021-07-21T20:19:04.850Z","category":"60d25b23765a5900437c8fce","parentDoc":null,"deprecated":false,"icon":"","mdx":{},"isBodyEmpty":false,"children":[]},{"_id":"6466838e94b6bb00501efe6a","api":{"method":"get","url":"","auth":"required","params":[],"examples":{"codes":[]},"results":{"codes":[{"name":"","code":"{}","language":"json","status":200},{"name":"","code":"{}","language":"json","status":400}]}},"title":"Community feedback documents","icon":"","type":"basic","slug":"feedback-docs","order":5,"isReference":false,"deprecated":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"community-feedback-documents","category":"60d25b23765a5900437c8fce","createdAt":"2023-05-18T19:59:10.204Z","parentDoc":null,"mdx":{},"isBodyEmpty":false,"children":[]},{"_id":"60d5e6e464e12b0055eda723","api":{"method":"get","url":"","auth":"required","results":{"codes":[{"name":"","code":"{}","language":"json","status":200},{"name":"","code":"{}","language":"json","status":400}]},"params":[]},"title":"Contact us","type":"basic","slug":"contact","order":6,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"get-in-touch","createdAt":"2021-06-25T14:23:32.577Z","category":"60d25b23765a5900437c8fce","parentDoc":null,"deprecated":false,"icon":"","isBodyEmpty":false,"children":[]}]},{"_id":"65ec6c03aff86d0072a566d7","title":"ROR Metadata","slug":"ror-metadata","order":3,"reference":false,"project":"6058e47681775f002de04832","version":"6058e47681775f002de04837","createdAt":"2024-03-09T14:02:43.834Z","__v":0,"pages":[{"_id":"60d25d9079d8a0002a2a0da0","api":{"method":"get","url":"","auth":"required","results":{"codes":[{"name":"","code":"{}","language":"json","status":200},{"name":"","code":"{}","language":"json","status":400}]},"params":[],"examples":{"codes":[]}},"title":"Updates and curation","type":"basic","slug":"updates","order":0,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"how-ror-is-updated","createdAt":"2021-06-22T22:00:48.485Z","category":"65ec6c03aff86d0072a566d7","parentDoc":null,"deprecated":false,"icon":"","mdx":{},"isBodyEmpty":false,"children":[]},{"_id":"60d25da0b85dae005598be27","api":{"method":"get","url":"","auth":"required","results":{"codes":[{"name":"","code":"{}","language":"json","status":200},{"name":"","code":"{}","language":"json","status":400}]},"params":[],"examples":{"codes":[]}},"title":"Data structure","type":"basic","slug":"data-structure","order":1,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"ror-data-structure","createdAt":"2021-06-22T22:01:04.607Z","category":"65ec6c03aff86d0072a566d7","parentDoc":null,"deprecated":false,"icon":"","mdx":{},"isBodyEmpty":false,"children":[]},{"_id":"6441a31ed32dc616a0b51f7b","api":{"method":"get","url":"","auth":"required","params":[]},"title":"Fields and sub-fields","icon":"","type":"basic","slug":"fields","order":2,"isReference":false,"deprecated":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"all-ror-fields-and-sub-fields","category":"65ec6c03aff86d0072a566d7","createdAt":"2023-04-20T20:39:58.302Z","parentDoc":null,"mdx":{},"isBodyEmpty":false,"children":[]},{"_id":"63ea71505bccd0025b40056a","api":{"method":"get","url":"","auth":"required","results":{"codes":[{"name":"","code":"{}","language":"json","status":200},{"name":"","code":"{}","language":"json","status":400}]},"params":[]},"title":"Relationships and hierarchies","icon":"","type":"basic","slug":"relationships","order":3,"isReference":false,"deprecated":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"ror-hierarchies-and-relationships","category":"65ec6c03aff86d0072a566d7","createdAt":"2023-02-13T17:20:16.915Z","parentDoc":null,"mdx":{},"isBodyEmpty":false,"children":[]},{"_id":"6441b9979730ea1a3d0b0afb","api":{"method":"get","url":"","auth":"required","params":[]},"title":"Schema versions","icon":"","type":"basic","slug":"schema-versions","order":4,"isReference":false,"deprecated":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"api-versioning-copy","parentDoc":null,"category":"65ec6c03aff86d0072a566d7","createdAt":"2023-04-20T22:15:51.461Z","isBodyEmpty":false,"children":[]},{"_id":"6464d64fef9bab0066e99315","api":{"method":"get","url":"","auth":"required","params":[],"examples":{"codes":[]},"results":{"codes":[{"name":"","code":"{}","language":"json","status":200},{"name":"","code":"{}","language":"json","status":400}]}},"title":"Schema 2.0","icon":"","type":"basic","slug":"schema-v2","order":5,"isReference":false,"deprecated":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"schema-v20","parentDoc":null,"category":"65ec6c03aff86d0072a566d7","createdAt":"2023-05-17T13:27:43.797Z","mdx":{},"isBodyEmpty":false,"children":[]},{"_id":"675c406280b1ad0069206e7e","mdx":{},"api":{"method":"get","url":"","auth":"required","params":[]},"title":"Schema 2.1","icon":"","type":"basic","slug":"schema-2-1","order":6,"isReference":false,"deprecated":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"schema-21","parentDoc":null,"category":"65ec6c03aff86d0072a566d7","createdAt":"2024-12-13T14:10:42.980Z","isBodyEmpty":false,"children":[]}]},{"_id":"653c1e6f1cd9f1004b55cc72","title":"ROR REST API","slug":"rest-api","order":5,"reference":false,"project":"6058e47681775f002de04832","version":"6058e47681775f002de04837","createdAt":"2023-10-27T20:32:47.999Z","__v":0,"pages":[{"_id":"63fc803674ca3e0045af2ddb","api":{"method":"get","url":"","auth":"required","results":{"codes":[{"name":"","code":"{}","language":"json","status":200},{"name":"","code":"{}","language":"json","status":400}]},"params":[],"examples":{"codes":[]}},"title":"About the ROR REST API","icon":"","type":"basic","slug":"rest-api","order":0,"isReference":false,"deprecated":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"api-about","category":"653c1e6f1cd9f1004b55cc72","createdAt":"2023-02-27T10:04:38.511Z","parentDoc":null,"mdx":{},"isBodyEmpty":false,"children":[]},{"_id":"6465068f99bbc20028cc7084","api":{"method":"get","url":"","auth":"required","params":[]},"title":"Retrieve a single record","icon":"","type":"basic","slug":"api-single","order":1,"isReference":false,"deprecated":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"retrieve-a-single-ror-record","parentDoc":null,"category":"653c1e6f1cd9f1004b55cc72","createdAt":"2023-05-17T16:53:35.628Z","mdx":{},"isBodyEmpty":false,"children":[]},{"_id":"6465071071aace1d6f61fd7e","api":{"method":"get","url":"","auth":"required","params":[]},"title":"Retrieve a list of records","icon":"","type":"basic","slug":"api-list","order":2,"isReference":false,"deprecated":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"retrieve-a-list-of-ror-records","parentDoc":null,"category":"653c1e6f1cd9f1004b55cc72","createdAt":"2023-05-17T16:55:44.021Z","mdx":{},"isBodyEmpty":false,"children":[]},{"_id":"646564ed6206730045608ea7","api":{"method":"get","url":"","auth":"required","params":[]},"title":"Filtering","icon":"","type":"basic","slug":"api-filtering","order":3,"isReference":false,"deprecated":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"filtering","parentDoc":null,"category":"653c1e6f1cd9f1004b55cc72","createdAt":"2023-05-17T23:36:13.204Z","mdx":{},"isBodyEmpty":false,"children":[]},{"_id":"646564bf25682100246d7641","api":{"method":"get","url":"","auth":"required","params":[]},"title":"Paging","icon":"","type":"basic","slug":"api-paging","order":4,"isReference":false,"deprecated":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"paging","parentDoc":null,"category":"653c1e6f1cd9f1004b55cc72","createdAt":"2023-05-17T23:35:27.796Z","mdx":{},"isBodyEmpty":false,"children":[]},{"_id":"63d1a47566e590002a7fc9d2","api":{"method":"get","url":"","auth":"required","results":{"codes":[{"name":"","code":"{}","language":"json","status":200},{"name":"","code":"{}","language":"json","status":400}]},"params":[],"examples":{"codes":[]}},"title":"Query parameter","icon":"","type":"basic","slug":"api-query","order":5,"isReference":false,"deprecated":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"query-parameter","category":"653c1e6f1cd9f1004b55cc72","createdAt":"2023-01-25T21:51:49.092Z","parentDoc":null,"mdx":{},"isBodyEmpty":false,"children":[]},{"_id":"641211ffd09495007a04c5b0","api":{"method":"get","url":"","auth":"required","results":{"codes":[{"name":"","code":"{}","language":"json","status":200},{"name":"","code":"{}","language":"json","status":400}]},"params":[]},"title":"Advanced query parameter","icon":"","type":"basic","slug":"api-advanced-query","order":6,"isReference":false,"deprecated":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"advanced-query-parameter","parentDoc":null,"category":"653c1e6f1cd9f1004b55cc72","createdAt":"2023-03-15T18:44:15.278Z","mdx":{},"isBodyEmpty":false,"children":[]},{"_id":"63d1a4b9149169004c68b881","api":{"method":"get","url":"","auth":"required","results":{"codes":[{"name":"","code":"{}","language":"json","status":200},{"name":"","code":"{}","language":"json","status":400}]},"params":[]},"title":"Affiliation parameter","icon":"","type":"basic","slug":"api-affiliation","order":7,"isReference":false,"deprecated":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"affiliation-parameter","parentDoc":null,"category":"653c1e6f1cd9f1004b55cc72","createdAt":"2023-01-25T21:52:57.629Z","mdx":{},"isBodyEmpty":false,"children":[]},{"_id":"6441a7b0de10cd149041710c","api":{"method":"get","url":"","auth":"required","params":[]},"title":"API versions","icon":"","type":"basic","slug":"api-versions","order":8,"isReference":false,"deprecated":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"schema-and-api-versioning-1","category":"653c1e6f1cd9f1004b55cc72","createdAt":"2023-04-20T20:59:28.209Z","parentDoc":null,"isBodyEmpty":false,"children":[]}]},{"_id":"60d25b780dfce1003f4547aa","title":"ROR Tools & Services","slug":"tools-services","order":6,"reference":false,"isAPI":false,"project":"6058e47681775f002de04832","version":"6058e47681775f002de04837","createdAt":"2021-06-22T21:51:52.183Z","__v":0,"pages":[{"_id":"60d3d01ac6b0030070645391","api":{"method":"get","url":"","auth":"required","results":{"codes":[{"name":"","code":"{}","language":"json","status":200},{"name":"","code":"{}","language":"json","status":400}]},"params":[],"examples":{"codes":[]}},"title":"Data dump","type":"basic","slug":"data-dump","order":0,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"","createdAt":"2021-06-24T00:21:46.090Z","category":"60d25b780dfce1003f4547aa","parentDoc":null,"deprecated":false,"icon":"","isBodyEmpty":false,"children":[]},{"_id":"60fee88bae1bb3000f317da2","api":{"method":"get","url":"","auth":"required","results":{"codes":[{"name":"","code":"{}","language":"json","status":200},{"name":"","code":"{}","language":"json","status":400}]},"params":[]},"title":"Web search","type":"basic","slug":"web-search","order":1,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"web-search-interface","createdAt":"2021-07-26T16:53:31.701Z","category":"60d25b780dfce1003f4547aa","parentDoc":null,"deprecated":false,"icon":"","mdx":{},"isBodyEmpty":false,"children":[]},{"_id":"60d3d0249841a7004a372925","api":{"method":"get","url":"","auth":"required","results":{"codes":[{"name":"","code":"{}","language":"json","status":200},{"name":"","code":"{}","language":"json","status":400}]},"params":[]},"title":"OpenRefine reconciler","type":"basic","slug":"openrefine-reconciler","order":2,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"","createdAt":"2021-06-24T00:21:56.714Z","category":"60d25b780dfce1003f4547aa","parentDoc":null,"deprecated":false,"icon":"","isBodyEmpty":false,"children":[]}]},{"_id":"64426d364b8f4c00604bb504","title":"Collecting ROR IDs","slug":"mapping-and-matching","order":7,"reference":false,"project":"6058e47681775f002de04832","version":"6058e47681775f002de04837","createdAt":"2023-04-21T11:02:14.913Z","__v":0,"pages":[{"_id":"6388f77b6c803f0024576f3d","api":{"method":"get","url":"","auth":"required","results":{"codes":[{"name":"","code":"{}","language":"json","status":200},{"name":"","code":"{}","language":"json","status":400}]},"params":[],"examples":{"codes":[]}},"title":"Create ROR-powered forms","icon":"","type":"basic","slug":"forms","order":0,"isReference":false,"deprecated":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"create-ror-powered-typeaheads","createdAt":"2022-12-01T18:50:35.957Z","category":"64426d364b8f4c00604bb504","parentDoc":null,"mdx":{},"isBodyEmpty":false,"children":[]},{"_id":"60d3e4c27dccd0004443bc84","api":{"method":"get","url":"","auth":"required","results":{"codes":[{"name":"","code":"{}","language":"json","status":200},{"name":"","code":"{}","language":"json","status":400}]},"params":[]},"title":"Match organization names to ROR IDs","type":"basic","slug":"matching","order":1,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"match-organization-names-to-ror-ids","createdAt":"2021-06-24T01:49:54.894Z","category":"64426d364b8f4c00604bb504","parentDoc":null,"deprecated":false,"icon":"","mdx":{},"isBodyEmpty":false,"children":[]},{"_id":"60d3e492c16abe006427745b","api":{"method":"get","url":"","auth":"required","results":{"codes":[{"name":"","code":"{}","language":"json","status":200},{"name":"","code":"{}","language":"json","status":400}]},"params":[],"examples":{"codes":[]}},"title":"Map other organization IDs to ROR IDs","type":"basic","slug":"mapping","order":2,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"map-other-organization-id-types-to-ror","createdAt":"2021-06-24T01:49:06.244Z","category":"64426d364b8f4c00604bb504","parentDoc":null,"deprecated":false,"icon":"","mdx":{},"isBodyEmpty":false,"children":[]},{"_id":"60f0d77625052e007e5fdeea","api":{"method":"get","url":"","auth":"required","results":{"codes":[{"name":"","code":"{}","language":"json","status":200},{"name":"","code":"{}","language":"json","status":400}]},"params":[]},"title":"Transition from GRID to ROR","type":"basic","slug":"grid","order":3,"isReference":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"gridror-transition-faq","createdAt":"2021-07-16T00:48:54.225Z","category":"64426d364b8f4c00604bb504","parentDoc":null,"deprecated":false,"icon":"","isBodyEmpty":false,"children":[]},{"_id":"65e8e50442039e001d1bf878","api":{"method":"get","url":"","auth":"required","params":[]},"title":"Transition from Open Funder Registry to ROR","icon":"","type":"basic","slug":"funder-registry","order":4,"isReference":false,"deprecated":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"open-funder-registry-ror-transition-faq","category":"64426d364b8f4c00604bb504","createdAt":"2024-03-06T21:49:56.732Z","parentDoc":null,"isBodyEmpty":false,"children":[]}]},{"_id":"60d25b63bd8660001006bcba","title":"Sending ROR IDs","slug":"implementation-how-to-guides","order":8,"reference":false,"isAPI":false,"project":"6058e47681775f002de04832","version":"6058e47681775f002de04837","createdAt":"2021-06-22T21:51:31.872Z","__v":0,"pages":[{"_id":"6441b9fc874e64005e3748cb","api":{"method":"get","url":"","auth":"required","params":[],"examples":{"codes":[]},"results":{"codes":[{"name":"","code":"{}","language":"json","status":200},{"name":"","code":"{}","language":"json","status":400}]}},"title":"Add ROR IDs to Crossref DOIs","icon":"","type":"basic","slug":"crossref","order":0,"isReference":false,"deprecated":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"include-ror-ids-in-crossref-dois","category":"60d25b63bd8660001006bcba","createdAt":"2023-04-20T22:17:32.825Z","parentDoc":null,"isBodyEmpty":false,"children":[]},{"_id":"6441ba1deda7550012b9c1df","api":{"method":"get","url":"","auth":"required","params":[]},"title":"Add ROR IDs to DataCite DOIs","icon":"","type":"basic","slug":"datacite","order":1,"isReference":false,"deprecated":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"include-ror-ids-in-datacite-dois","category":"60d25b63bd8660001006bcba","createdAt":"2023-04-20T22:18:05.994Z","parentDoc":null,"isBodyEmpty":false,"children":[]},{"_id":"6320a168f8e794131108ae63","api":{"method":"get","url":"","auth":"required","results":{"codes":[{"name":"","code":"{}","language":"json","status":200},{"name":"","code":"{}","language":"json","status":400}]},"params":[]},"title":"Add ROR IDs to JATS XML","icon":"","type":"basic","slug":"jats","order":2,"isReference":false,"deprecated":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"include-ror-ids-in-jats-xml","createdAt":"2022-09-13T15:27:36.976Z","category":"60d25b63bd8660001006bcba","parentDoc":null,"isBodyEmpty":false,"children":[]},{"_id":"6182d13df84631005aa3c8e9","api":{"method":"get","url":"","auth":"required","results":{"codes":[{"name":"","code":"{}","language":"json","status":200},{"name":"","code":"{}","language":"json","status":400}]},"params":[],"examples":{"codes":[]}},"title":"Add ROR IDs to ORCID records","type":"basic","slug":"orcid","order":3,"isReference":false,"deprecated":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"previousSlug":"include-ror-ids-in-orcid-record-data","createdAt":"2021-11-03T18:13:17.918Z","category":"60d25b63bd8660001006bcba","parentDoc":null,"icon":"","isBodyEmpty":false,"children":[]}]}],"refs":[]},"baseUrl":"/","apiBaseUrl":"/","search":{"appId":"T28YKFATPY","searchApiKey":"ODczNzdiMDdiZDc1ZWRiOGQyYWVlYzVjMTdiMjg3ZmEwNWUyZDk3YWJlMDc5ZTliNmFhNTE2ZWY3ZDhiOGUyZnRhZ0ZpbHRlcnM9KHByb2plY3Q6NjA1OGU0NzY4MTc3NWYwMDJkZTA0ODMyKSwodmVyc2lvbjpub25lLHZlcnNpb246NjA1OGU0NzY4MTc3NWYwMDJkZTA0ODM3KSwoaGlkZGVuOm5vbmUsaGlkZGVuOmZhbHNlKSwoaW5kZXg6Q3VzdG9tUGFnZSxpbmRleDpQYWdlLGluZGV4OkJsb2cp","indexName":"readme_search_v2","projectsMeta":[{"modules":{"landing":true,"docs":true,"examples":false,"reference":false,"changelog":true,"discuss":false,"suggested_edits":true,"logs":false,"custompages":false,"tutorials":false,"graphql":false},"id":"6058e47681775f002de04832","name":"ROR","subdomain":"ror","subpath":"","nav_names":{"docs":"","reference":"","changelog":"","discuss":"","tutorials":"","recipes":""}}],"UrlManager":{"options":{"child":false,"parent":null,"hasOneChild":false,"project":null,"version":null,"lang":"en"},"defaults":{"lang":"en"}},"urlManagerOpts":{"lang":"en","parent":{"childrenProjects":[]},"project":{"subdomain":"ror"},"version":"1"}},"activeDoc":"matching","rdmd":{"baseUrl":"/","body":"If you have organization names or full affiliation strings stored in your system as text, there are several approaches to matching those text strings to ROR IDs. \n\nThe approaches given below are for cases when you have a list, a spreadsheet, or a database with organization information as text strings, often with \"extra\" text such as a department or address as well as the organization's name, but no corresponding organization IDs. \n\nExamples of organization names and affiliation information as text strings and the corresponding ROR ID: \n\n- University of Haifa > <https://ror.org/02f009v59> \n- University of ManchesterGreater Manchester Mental Health NHS Foundation TrustNational Institute for Health Research (NIHR) Greater Manchester Patient Safety Translational Research Centre > <https://ror.org/05sb89p83> \n- Atmospheric Sciences and Global Change Division, Pacific Northwest National Laboratory, Richland, WA, USA > <https://ror.org/05h992307> \n\n> 📘 Mapping names and IDs to ROR\n> \n> If you have organization names along with another global organization ID (Crossref Funder ID, GRID, ISNI, or Wikidata), you may find quicker, more accurate results by mapping those other IDs to ROR. See [Map other organization ID types to ROR](doc:mapping). \n> \n> If you need to match ROR IDs to user input in a web application, see [Create ROR-powered typeaheads in forms](doc:forms).\n\n## Match organization names to ROR IDs using the ROR API\n\n### Query vs affiliation parameter\n\nThe [ROR API](doc:api-about) offers 2 ways to search ROR records, which work slightly differently and return different results:\n\n- **[Affiliation parameter](#affiliation-parameter-approach)** `/organizations?affiliation=`: Searches `name`, `aliases`, and `labels` fields using different search algorithms and returns the best match(es) based on matching score. Includes matching score and true/false indicator of whether the score is high enough to be considered a reliable match. Produces about 85% correct matches in our tests; individual implementations may see better or worse results. \n\n- **[Query parameter](#query-parameter-approach)** `/organizations?query=`: Searches `name`, `aliases`, `labels`, `acronyms`, and `external_ids` fields in ROR records and returns all matching records. Does NOT include a matching score or true/false indicator of whether the score is high enough to be considered a reliable match.\n\nFor cases where you have relatively unique organization names or full affiliation strings, use the [affiliation parameter approach](#affiliation-parameter-approach). Works for both English and non-English name variations. Examples:\n\n- Incorporated Research Institutions for Seismology (IRIS)\n- Universitätsbibliothek der Ludwig-Maximilians-Universität München\n- Department of Civil and Industrial Engineering, University of Pisa, Largo Lucio Lazzarino 2, Pisa 56126, Italy\n\nFor cases where you have very common organization names, use the [query parameter approach](#query-parameter-approach) to look for keywords from the organization's name or the exact name of the organization surrounded by double quotation marks, and consider using filters for organization type and country. Examples:\n\n- Ministry of Health\n- National Research Council\n- York University\n\n> 📘 Retrieving active and inactive organizations\n> \n> By default, both the affiliation parameter and the query parameter will return only records with an active [status](doc:data-structure#status): `status: \"active\"`. Consider whether you also want to retrieve records with an inactive status; inactive records generally represent organizations that no longer operate. See [API filtering](doc:api-filtering) for details. \n> \n> Be aware too that inactive organizations may be succeeded by a new organization under a different name with a different ROR ID. If you do retrieve inactive organizations, check the `relationships` field of an inactive record to see if it has a [Successor organization](doc:data-structure#relationships).\n\n### Affiliation parameter approach\n\nSearches `name`, `aliases` and `labels` 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>`. For the full list of fields returned, see [Fields and sub-fields](doc:fields).\n\n```curl\ncurl 'https://api.ror.org/v1/organizations?affiliation=university+of+wisconsin+madison' | json_pp\n```\n\nIf there's a high-confidence match, it will appear as the first result, with `\"chosen\": true`. Other results and their matching score will also be returned, but if you're automating this process using a script, we recommend using results with `\"chosen\": true` rather than relying on the score. Results are paginated: see [API paging](doc:api-paging) for details.\n\n```json\n{\n \"items\" : [\n {\n \"chosen\" : true,\n \"matching_type\" : \"EXACT\",\n \"organization\" : {\n \"acronyms\" : [\n \"UW\"\n ],\n \"addresses\" : [\n {\n \"city\" : \"Madison\",\n \"country_geonames_id\" : null,\n \"geonames_city\" : {\n \"city\" : \"Madison\",\n \"geonames_admin1\" : {\n \"ascii_name\" : null,\n \"code\" : \"US.WI\",\n \"id\" : null,\n \"name\" : \"Wisconsin\"\n },\n \"geonames_admin2\" : {\n \"ascii_name\" : null,\n \"code\" : null,\n \"id\" : null,\n \"name\" : null\n },\n \"id\" : 5261457,\n \"license\" : {\n \"attribution\" : \"Data from geonames.org under a CC-BY 3.0 license\",\n \"license\" : \"http://creativecommons.org/licenses/by/3.0/\"\n },\n \"nuts_level1\" : {\n \"code\" : null,\n \"name\" : null\n },\n \"nuts_level2\" : {\n \"code\" : null,\n \"name\" : null\n },\n \"nuts_level3\" : {\n \"code\" : null,\n \"name\" : null\n }\n },\n \"lat\" : 43.07305,\n \"line\" : null,\n \"lng\" : -89.40123,\n \"postcode\" : null,\n \"primary\" : false,\n \"state\" : null,\n \"state_code\" : null\n }\n ],\n \"aliases\" : [\n \"UW–Madison\"\n ],\n \"country\" : {\n \"country_code\" : \"US\",\n \"country_name\" : \"United States\"\n },\n \"email_address\" : null,\n \"established\" : 1848,\n \"external_ids\" : {\n \"FundRef\" : {\n \"all\" : [\n \"100007015\",\n \"100008959\",\n \"100005996\",\n \"100007870\",\n \"100008301\",\n \"100008028\",\n \"100008237\",\n \"100008161\",\n \"100010495\",\n \"100009627\",\n \"100010284\",\n \"100005911\",\n \"100007925\",\n \"100005902\",\n \"100012787\"\n ],\n \"preferred\" : \"100007015\"\n },\n \"GRID\" : {\n \"all\" : \"grid.14003.36\",\n \"preferred\" : \"grid.14003.36\"\n },\n \"ISNI\" : {\n \"all\" : [\n \"0000 0001 2167 3675\"\n ],\n \"preferred\" : null\n },\n \"Wikidata\" : {\n \"all\" : [\n \"Q838330\",\n \"Q33122195\",\n \"Q7662222\"\n ],\n \"preferred\" : \"Q838330\"\n }\n },\n \"id\" : \"https://ror.org/01y2jtd41\",\n \"ip_addresses\" : [],\n \"labels\" : [\n {\n \"iso639\" : \"es\",\n \"label\" : \"Universidad de Wisconsin-Madison\"\n },\n {\n \"iso639\" : \"fr\",\n \"label\" : \"Université du Wisconsin à Madison\"\n }\n ],\n \"links\" : [\n \"http://www.wisc.edu/\"\n ],\n \"name\" : \"University of Wisconsin–Madison\",\n \"relationships\" : [\n {\n \"id\" : \"https://ror.org/05cb4rb43\",\n \"label\" : \"Morgridge Institute for Research\",\n \"type\" : \"Child\"\n },\n {\n \"id\" : \"https://ror.org/04gq8q482\",\n \"label\" : \"North Temperate Lakes Long Term Ecological Research\",\n \"type\" : \"Child\"\n },\n {\n \"id\" : \"https://ror.org/03ydkyb10\",\n \"label\" : \"University of Wisconsin System\",\n \"type\" : \"Parent\"\n },\n {\n \"id\" : \"https://ror.org/03b8vas82\",\n \"label\" : \"National Atmospheric Deposition Program\",\n \"type\" : \"Related\"\n },\n {\n \"id\" : \"https://ror.org/04r3s7465\",\n \"label\" : \"McMurdo Dry Valleys Long Term Ecological Research\",\n \"type\" : \"Related\"\n },\n {\n \"id\" : \"https://ror.org/02kj3rm24\",\n \"label\" : \"Wisconsin Geological and Natural History Survey\",\n \"type\" : \"Child\"\n }\n ],\n \"status\" : \"active\",\n \"types\" : [\n \"Education\",\n \"Funder\"\n ],\n \"wikipedia_url\" : \"http://en.wikipedia.org/wiki/University_of_Wisconsin%E2%80%93Madison\"\n },\n \"score\" : 1,\n \"substring\" : \"university of wisconsin madison\"\n },\n {\n \"chosen\" : false,\n \"matching_type\" : \"EXACT\",\n \"organization\" : {\n \"acronyms\" : [\n \"UWHC\"\n ],\n \"addresses\" : [\n {\n \"city\" : \"Madison\",\n \"country_geonames_id\" : null,\n \"geonames_city\" : {\n \"city\" : \"Madison\",\n \"geonames_admin1\" : {\n \"ascii_name\" : null,\n \"code\" : \"US.WI\",\n \"id\" : null,\n \"name\" : \"Wisconsin\"\n },\n \"geonames_admin2\" : {\n \"ascii_name\" : null,\n \"code\" : null,\n \"id\" : null,\n \"name\" : null\n },\n \"id\" : 5261457,\n \"license\" : {\n \"attribution\" : \"Data from geonames.org under a CC-BY 3.0 license\",\n \"license\" : \"http://creativecommons.org/licenses/by/3.0/\"\n },\n \"nuts_level1\" : {\n \"code\" : null,\n \"name\" : null\n },\n \"nuts_level2\" : {\n \"code\" : null,\n \"name\" : null\n },\n \"nuts_level3\" : {\n \"code\" : null,\n \"name\" : null\n }\n },\n \"lat\" : 43.07305,\n \"line\" : null,\n \"lng\" : -89.40123,\n \"postcode\" : null,\n \"primary\" : false,\n \"state\" : null,\n \"state_code\" : null\n }\n ],\n \"aliases\" : [\n \"UW Hospital and Clinics\",\n \"University of Wisconsin Health University Hospital\",\n \"University of Wisconsin Hospital and Clinics\",\n \"University of Wisconsin-Madison Hospital\",\n \"Wisconsin General Hospital\"\n ],\n \"country\" : {\n \"country_code\" : \"US\",\n \"country_name\" : \"United States\"\n },\n \"email_address\" : null,\n \"established\" : 1924,\n \"external_ids\" : {\n \"GRID\" : {\n \"all\" : \"grid.412647.2\",\n \"preferred\" : \"grid.412647.2\"\n },\n \"ISNI\" : {\n \"all\" : [\n \"0000 0000 9209 0955\"\n ],\n \"preferred\" : null\n },\n \"Wikidata\" : {\n \"all\" : [\n \"Q7896631\"\n ],\n \"preferred\" : null\n }\n },\n \"id\" : \"https://ror.org/02mqqhj42\",\n \"ip_addresses\" : [],\n \"labels\" : [],\n \"links\" : [\n \"https://www.uwhealth.org/locations/university-hospital-170\"\n ],\n \"name\" : \"UW Health University Hospital\",\n \"relationships\" : [\n {\n \"id\" : \"https://ror.org/01e4byj08\",\n \"label\" : \"University of Wisconsin Carbone Cancer Center\",\n \"type\" : \"Child\"\n },\n {\n \"id\" : \"https://ror.org/03e3qgk42\",\n \"label\" : \"University of Wisconsin Health\",\n \"type\" : \"Parent\"\n }\n ],\n \"status\" : \"active\",\n \"types\" : [\n \"Healthcare\"\n ],\n \"wikipedia_url\" : \"https://en.wikipedia.org/wiki/University_of_Wisconsin_Hospital_and_Clinics\"\n },\n \"score\" : 0.87,\n \"substring\" : \"university of wisconsin madison\"\n },\n {\n \"chosen\" : false,\n \"matching_type\" : \"EXACT\",\n \"organization\" : {\n \"acronyms\" : [\n \"UWCCC\"\n ],\n \"addresses\" : [\n {\n \"city\" : \"Madison\",\n \"country_geonames_id\" : null,\n \"geonames_city\" : {\n \"city\" : \"Madison\",\n \"geonames_admin1\" : {\n \"ascii_name\" : null,\n \"code\" : \"US.WI\",\n \"id\" : null,\n \"name\" : \"Wisconsin\"\n },\n \"geonames_admin2\" : {\n \"ascii_name\" : null,\n \"code\" : null,\n \"id\" : null,\n \"name\" : null\n },\n \"id\" : 5261457,\n \"license\" : {\n \"attribution\" : \"Data from geonames.org under a CC-BY 3.0 license\",\n \"license\" : \"http://creativecommons.org/licenses/by/3.0/\"\n },\n \"nuts_level1\" : {\n \"code\" : null,\n \"name\" : null\n },\n \"nuts_level2\" : {\n \"code\" : null,\n \"name\" : null\n },\n \"nuts_level3\" : {\n \"code\" : null,\n \"name\" : null\n }\n },\n \"lat\" : 43.07305,\n \"line\" : null,\n \"lng\" : -89.40123,\n \"postcode\" : null,\n \"primary\" : false,\n \"state\" : null,\n \"state_code\" : null\n }\n ],\n \"aliases\" : [\n \"Carbone Cancer Center\",\n \"UW Carbone\",\n \"UW Carbone Cancer Center\",\n \"UW Carbone Comprehensive Cancer Center\",\n \"UWCCC Madison\",\n \"University of Wisconsin Cancer Center\",\n \"University of Wisconsin Carbone Comprehensive Cancer Center\",\n \"University of Wisconsin Comprehensive Cancer Center\",\n \"University of Wisconsin-Madison Carbone Cancer Center\"\n ],\n \"country\" : {\n \"country_code\" : \"US\",\n \"country_name\" : \"United States\"\n },\n \"email_address\" : null,\n \"established\" : 1940,\n \"external_ids\" : {\n \"FundRef\" : {\n \"all\" : [\n \"100007923\"\n ],\n \"preferred\" : \"100007923\"\n },\n \"GRID\" : {\n \"all\" : \"grid.412639.b\",\n \"preferred\" : \"grid.412639.b\"\n },\n \"ISNI\" : {\n \"all\" : [\n \"0000 0001 2191 1477\"\n ],\n \"preferred\" : null\n },\n \"Wikidata\" : {\n \"all\" : [\n \"Q7876154\"\n ],\n \"preferred\" : null\n }\n },\n \"id\" : \"https://ror.org/01e4byj08\",\n \"ip_addresses\" : [],\n \"labels\" : [],\n \"links\" : [\n \"https://cancer.wisc.edu\"\n ],\n \"name\" : \"University of Wisconsin Carbone Cancer Center\",\n \"relationships\" : [\n {\n \"id\" : \"https://ror.org/02mqqhj42\",\n \"label\" : \"UW Health University Hospital\",\n \"type\" : \"Parent\"\n }\n ],\n \"status\" : \"active\",\n \"types\" : [\n \"Funder\",\n \"Healthcare\"\n ],\n \"wikipedia_url\" : \"https://en.wikipedia.org/wiki/University_of_Wisconsin_Carbone_Cancer_Center\"\n },\n \"score\" : 0.76,\n \"substring\" : \"university of wisconsin madison\"\n }\n ],\n \"number_of_results\" : 3\n}\n```\n\n> 🚧 Don't automatically select the first \"unchosen\" result of an ?affiliation query with no `chosen: true` result\n> \n> When no result has `\"chosen\": true`, the first result is not necessarily the best match for a given affiliation string. In that case, several results may have the exact same score and/or there may be no match with a high score. Because the affiliation service breaks a given affiliation string into multiple substrings and performs searches of each substring on its own as well as in combination with other substrings, a high scoring match that is not selected as chosen may be a match to only a small portion of the entire affiliation string. In these cases, it is best to respect the absence of `\"chosen: true\"` and leave the string unmatched or add a layer of human or machine assignment, at your discretion.\n\n#### Additional request examples:\n\nIncorporated Research Institutions for Seismology (IRIS)\n\n```curl\ncurl 'https://api.ror.org/v1/organizations?affiliation=Incorporated%20Research%20Institutions%20for%20Seismology%20(IRIS)' | json_pp\n```\n\nUniversitätsbibliothek der Ludwig-Maximilians-Universität München\n\n```curl\ncurl 'https://api.ror.org/v1/organizations?affiliation=Universit%C3%A4tsbibliothek%20der%20Ludwig-Maximilians-Universit%C3%A4t%20M%C3%BCnchen' | json_pp\n```\n\nDepartment of Civil and Industrial Engineering, University of Pisa, Largo Lucio Lazzarino 2, Pisa 56126, Italy\n\n```curl\ncurl 'https://api.ror.org/v1/organizations?affiliation=Department%20of%20Civil%20and%20Industrial%20Engineering%2C%20University%20of%20Pisa%2C%20Largo%20Lucio%20Lazzarino%202%2C%20Pisa%2056126%2C%20Italy' | json_pp\n```\n\n### Query parameter approach\n\nSearch all indexed fields in ROR records using the format `https://api.ror.org/organizations?query=<search term>&filter=<filters>`. We strongly recommend using [organization type and country filters](doc:filtering). For more information, see the [REST API guide](doc:rest-api).\n\n```curl\ncurl 'https://api.ror.org/v1/organizations?query=%22Ministry+of+Health%22&filter=types:Government,country.country_code:NZ' | json_pp\n```\n\nThe response is a JSON object containing full records for the first 20 search results. Results are paginated: see [API paging](doc:api-paging) for details. Matching scores are not included, but closest matches are at the beginning of the list. \n\n> 📘 Query parameter searches may return many results, so some amount of human intervention may be needed to determine the matching ROR ID (if there is one).\n\n```curl\n{\n \"items\" : [\n {\n \"acronyms\" : [],\n \"addresses\" : [\n {\n \"city\" : \"Wellington\",\n \"country_geonames_id\" : null,\n \"geonames_city\" : {\n \"city\" : \"Wellington\",\n \"geonames_admin1\" : {\n \"ascii_name\" : null,\n \"code\" : \"NZ.WGN\",\n \"id\" : null,\n \"name\" : \"Wellington Region\"\n },\n \"geonames_admin2\" : {\n \"ascii_name\" : null,\n \"code\" : null,\n \"id\" : null,\n \"name\" : null\n },\n \"id\" : 2179537,\n \"license\" : {\n \"attribution\" : \"Data from geonames.org under a CC-BY 3.0 license\",\n \"license\" : \"http://creativecommons.org/licenses/by/3.0/\"\n },\n \"nuts_level1\" : {\n \"code\" : null,\n \"name\" : null\n },\n \"nuts_level2\" : {\n \"code\" : null,\n \"name\" : null\n },\n \"nuts_level3\" : {\n \"code\" : null,\n \"name\" : null\n }\n },\n \"lat\" : -41.28664,\n \"line\" : null,\n \"lng\" : 174.77557,\n \"postcode\" : null,\n \"primary\" : false,\n \"state\" : null,\n \"state_code\" : null\n }\n ],\n \"aliases\" : [\n \"Manatū Hauora\"\n ],\n \"country\" : {\n \"country_code\" : \"NZ\",\n \"country_name\" : \"New Zealand\"\n },\n \"email_address\" : null,\n \"established\" : 1903,\n \"external_ids\" : {\n \"FundRef\" : {\n \"all\" : [\n \"501100001504\"\n ],\n \"preferred\" : null\n },\n \"GRID\" : {\n \"all\" : \"grid.415708.f\",\n \"preferred\" : \"grid.415708.f\"\n },\n \"ISNI\" : {\n \"all\" : [\n \"0000 0004 0483 5988\"\n ],\n \"preferred\" : null\n },\n \"Wikidata\" : {\n \"all\" : [\n \"Q16933991\"\n ],\n \"preferred\" : null\n }\n },\n \"id\" : \"https://ror.org/00vjb5165\",\n \"ip_addresses\" : [],\n \"labels\" : [],\n \"links\" : [\n \"http://www.health.govt.nz/\"\n ],\n \"name\" : \"Ministry of Health\",\n \"relationships\" : [],\n \"status\" : \"active\",\n \"types\" : [\n \"Government\",\n \"Funder\"\n ],\n \"wikipedia_url\" : \"https://en.wikipedia.org/wiki/Ministry_of_Health_(New_Zealand)\"\n }\n ],\n \"meta\" : {\n \"countries\" : [\n {\n \"count\" : 1,\n \"id\" : \"nz\",\n \"title\" : \"New Zealand\"\n }\n ],\n \"statuses\" : [\n {\n \"count\" : 1,\n \"id\" : \"active\",\n \"title\" : \"active\"\n }\n ],\n \"types\" : [\n {\n \"count\" : 1,\n \"id\" : \"funder\",\n \"title\" : \"Funder\"\n },\n {\n \"count\" : 1,\n \"id\" : \"government\",\n \"title\" : \"Government\"\n }\n ]\n },\n \"number_of_results\" : 1,\n \"time_taken\" : 6\n}\n```\n\n## Matching a list of organization names to ROR IDs using a script\n\nYou can write your own script to match a list of organization names to ROR IDs via the ROR API, though some manual intervention will likely be needed to make sure that matches are correct. If you are writing a script, remember the following:\n\n- Try the [affiliation parameter approach](#affiliation-parameter-approach) first instead of the [query parameter approach](#query-parameter-approach).\n- Look for \"chosen\" results where `\"chosen\": true`. \n- If no results are found, try alternate names/acronyms (if you have them) or try the query parameter approach. \n- API results are paginated: see [API paging](#api-paging) for details.\n- By default, API requests will return only records with an active [status](doc:data-structure#status): `status: \"active\"`. Consider whether you want to retrieve records with an inactive status as well; inactive records generally represent organizations that no longer operate. See [API filtering](doc:api-filtering) for details. \n\nSee, use, and clone examples of Python scripts that match organization names to ROR IDs in the [ror-utilities Github repository](https://github.com/ror-community/ror-utilities).\n\n## Match organization names to ROR IDs using the data dump\n\nInstead of using the ROR API, you can use your own scripts or processing tools on the [ROR data dump](doc:data-dump) to match organization names to ROR IDs. Advantages of this approach include:\n\n- Fine-grained control over matching criteria\n- Faster processing in cases where you have many IDs to map\n- No chance of error responses due to network interruptions or API outages\n\n## Match organization names to ROR using OpenRefine\n\nThe **ROR OpenRefine Reconciler** is a fairly labor-intensive way of matching organization names to ROR IDs, but it works well for those who have a relatively small list of organization names, those who want to have a high degree of control and oversight over the matching process, and those who do not want to write code. \n\n[OpenRefine](https://openrefine.org) (formerly Google Refine) is a free, open source desktop tool for cleaning up messy data stored in common formats like CSV, JSON, XML, XLS. You can even use it to connect to SQL-based databases and Google Sheets. \n\nSee [ROR OpenRefine Reconciler](doc:openrefine-reconciler) for written usage instructions, screenshots, and a tutorial video. \n\n## Match organization names to ROR IDs using third-party tools\n\nSeveral projects and researchers have developed scripts and/or machine learning and artificial intelligence tools that match textual organization information to ROR IDs. Several of these tools are fast and can work with large amounts of data with accuracy rates before human intervention ranging from about 85% to 95%. These tools are not officially supported by ROR, but we list them here in case you find them useful. \n\n- [OpenAlex Institution Parsing](https://github.com/ourresearch/openalex-institution-parsing) by OurResearch\n\n- [S2AFF - Semantic Scholar Affiliations Linker](https://github.com/allenai/S2AFF/) by the Allen AI Institute\n\n- [RORRetriever](https://github.com/Metadata-Game-Changers/RORRetriever) by Metadata Game Changers\n\n- [EMBL-EBI ROR Predictor prototype](https://gitlab.ebi.ac.uk/literature-services/public-projects/ROR-proto-EMBL) by EMBL-EBI for [Project FREYA](https://www.project-freya.eu/Plone/en)\n\n- [dataESR affiliation matcher](https://github.com/dataesr/affiliation-matcher) developed by Anne L'Hôte and Eric Jeangirard for the French Ministry of Higher Education\n\n- [OpenAlex ROR Predictor (gpu-based)](https://github.com/adambuttrick/openalex-ror-predictor) by ROR Curation Lead Adam Buttrick\n\n- [fastText ROR Predictor (cpu-based)](https://github.com/adambuttrick/ror-predictor-fasttext) by ROR Curation Lead Adam Buttrick\n\n- [lr_predictor](https://github.com/adambuttrick/lr_matches) by ROR Curation Lead Adam Buttrick\n\n- [ROR experimental affiliation matching](https://github.com/ror-community/affiliation-matching-experimental) - A collection of data and code for training models and experimenting with automatically matching affiliation strings to ROR IDs. Not production code, and not officially supported by ROR. \n\n## Testing and training data\n\nROR is currently experimenting with strategies for automatically matching affiliation strings to ROR IDs, and we have collected sets of data from Springer Nature, the American Physical Society, Crossref, and OpenAlex for testing and training matching strategies that are openly available at <https://github.com/ror-community/affiliation-matching-experimental/tree/main/test_data>. These datasets include affiliation text strings from production systems that have been matched to ROR IDs with varying levels of human review.","dehydrated":{"toc":"<nav><ul class=\"toc-list\"><li><a class=\"tocHeader\" href=\"#\"><i class=\"icon icon-text-align-left\"></i>Table of Contents</a></li><li class=\"toc-children\"><ul>\n<li>\n<a href=\"#match-organization-names-to-ror-ids-using-the-ror-api\">Match organization names to ROR IDs using the ROR API</a>\n<ul>\n<li><a href=\"#query-vs-affiliation-parameter\">Query vs affiliation parameter</a></li>\n<li><a href=\"#affiliation-parameter-approach\">Affiliation parameter approach</a></li>\n<li><a href=\"#query-parameter-approach\">Query parameter approach</a></li>\n</ul>\n</li>\n<li>\n<a href=\"#matching-a-list-of-organization-names-to-ror-ids-using-a-script\">Matching a list of organization names to ROR IDs using a script</a>\n</li>\n<li>\n<a href=\"#match-organization-names-to-ror-ids-using-the-data-dump\">Match organization names to ROR IDs using the data dump</a>\n</li>\n<li>\n<a href=\"#match-organization-names-to-ror-using-openrefine\">Match organization names to ROR using OpenRefine</a>\n</li>\n<li>\n<a href=\"#match-organization-names-to-ror-ids-using-third-party-tools\">Match organization names to ROR IDs using third-party tools</a>\n</li>\n<li>\n<a href=\"#testing-and-training-data\">Testing and training data</a>\n</li>\n</ul></li></ul></nav>","body":"<p>If you have organization names or full affiliation strings stored in your system as text, there are several approaches to matching those text strings to ROR IDs. </p>\n<p>The approaches given below are for cases when you have a list, a spreadsheet, or a database with organization information as text strings, often with &quot;extra&quot; text such as a department or address as well as the organization&#x27;s name, but no corresponding organization IDs. </p>\n<p>Examples of organization names and affiliation information as text strings and the corresponding ROR ID: </p>\n<ul>\n<li>University of Haifa &gt; <a href=\"https://ror.org/02f009v59\" target=\"\" title=\"\">https://ror.org/02f009v59</a> </li>\n<li>University of ManchesterGreater Manchester Mental Health NHS Foundation TrustNational Institute for Health Research (NIHR) Greater Manchester Patient Safety Translational Research Centre &gt; <a href=\"https://ror.org/05sb89p83\" target=\"\" title=\"\">https://ror.org/05sb89p83</a> </li>\n<li>Atmospheric Sciences and Global Change Division, Pacific Northwest National Laboratory, Richland, WA, USA &gt; <a href=\"https://ror.org/05h992307\" target=\"\" title=\"\">https://ror.org/05h992307</a> </li>\n</ul>\n<blockquote class=\"callout callout_info\" theme=\"📘\"><h2 class=\"callout-heading\"><span class=\"callout-icon\">📘</span><p>Mapping names and IDs to ROR</p></h2><p>If you have organization names along with another global organization ID (Crossref Funder ID, GRID, ISNI, or Wikidata), you may find quicker, more accurate results by mapping those other IDs to ROR. See <a href=\"/docs/mapping\" target=\"\" title=\"\" class=\"doc-link\" data-sidebar=\"mapping\">Map other organization ID types to ROR</a>. </p><p>If you need to match ROR IDs to user input in a web application, see <a href=\"/docs/forms\" target=\"\" title=\"\" class=\"doc-link\" data-sidebar=\"forms\">Create ROR-powered typeaheads in forms</a>.</p></blockquote>\n<h2 class=\"heading heading-2 header-scroll\" align=\"\"><div class=\"heading-anchor anchor waypoint\" id=\"match-organization-names-to-ror-ids-using-the-ror-api\"></div><div class=\"heading-text\"><div id=\"section-match-organization-names-to-ror-i-ds-using-the-ror-api\" class=\"heading-anchor_backwardsCompatibility\"></div>Match organization names to ROR IDs using the ROR API</div><a aria-label=\"Skip link to Match organization names to ROR IDs using the ROR API\" class=\"heading-anchor-icon fa fa-anchor\" href=\"#match-organization-names-to-ror-ids-using-the-ror-api\"></a></h2>\n<h3 class=\"heading heading-3 header-scroll\" align=\"\"><div class=\"heading-anchor anchor waypoint\" id=\"query-vs-affiliation-parameter\"></div><div class=\"heading-text\"><div id=\"section-query-vs-affiliation-parameter\" class=\"heading-anchor_backwardsCompatibility\"></div>Query vs affiliation parameter</div><a aria-label=\"Skip link to Query vs affiliation parameter\" class=\"heading-anchor-icon fa fa-anchor\" href=\"#query-vs-affiliation-parameter\"></a></h3>\n<p>The <a href=\"/docs/api-about\" target=\"\" title=\"\" class=\"doc-link\" data-sidebar=\"api-about\">ROR API</a> offers 2 ways to search ROR records, which work slightly differently and return different results:</p>\n<ul>\n<li>\n<p><strong><a href=\"#affiliation-parameter-approach\" target=\"\" title=\"\">Affiliation parameter</a></strong> <button aria-label=\"Copy Code\" class=\"rdmd-code-copy fa\"></button><code class=\"rdmd-code lang- theme-light\" data-lang=\"\" name=\"\" tabindex=\"0\">/organizations?affiliation=</code>: Searches <button aria-label=\"Copy Code\" class=\"rdmd-code-copy fa\"></button><code class=\"rdmd-code lang- theme-light\" data-lang=\"\" name=\"\" tabindex=\"0\">name</code>, <button aria-label=\"Copy Code\" class=\"rdmd-code-copy fa\"></button><code class=\"rdmd-code lang- theme-light\" data-lang=\"\" name=\"\" tabindex=\"0\">aliases</code>, and <button aria-label=\"Copy Code\" class=\"rdmd-code-copy fa\"></button><code class=\"rdmd-code lang- theme-light\" data-lang=\"\" name=\"\" tabindex=\"0\">labels</code> fields using different search algorithms and returns the best match(es) based on matching score. Includes matching score and true/false indicator of whether the score is high enough to be considered a reliable match. Produces about 85% correct matches in our tests; individual implementations may see better or worse results. </p>\n</li>\n<li>\n<p><strong><a href=\"#query-parameter-approach\" target=\"\" title=\"\">Query parameter</a></strong> <button aria-label=\"Copy Code\" class=\"rdmd-code-copy fa\"></button><code class=\"rdmd-code lang- theme-light\" data-lang=\"\" name=\"\" tabindex=\"0\">/organizations?query=</code>: Searches <button aria-label=\"Copy Code\" class=\"rdmd-code-copy fa\"></button><code class=\"rdmd-code lang- theme-light\" data-lang=\"\" name=\"\" tabindex=\"0\">name</code>, <button aria-label=\"Copy Code\" class=\"rdmd-code-copy fa\"></button><code class=\"rdmd-code lang- theme-light\" data-lang=\"\" name=\"\" tabindex=\"0\">aliases</code>, <button aria-label=\"Copy Code\" class=\"rdmd-code-copy fa\"></button><code class=\"rdmd-code lang- theme-light\" data-lang=\"\" name=\"\" tabindex=\"0\">labels</code>, <button aria-label=\"Copy Code\" class=\"rdmd-code-copy fa\"></button><code class=\"rdmd-code lang- theme-light\" data-lang=\"\" name=\"\" tabindex=\"0\">acronyms</code>, and <button aria-label=\"Copy Code\" class=\"rdmd-code-copy fa\"></button><code class=\"rdmd-code lang- theme-light\" data-lang=\"\" name=\"\" tabindex=\"0\">external_ids</code> fields in ROR records and returns all matching records. Does NOT include a matching score or true/false indicator of whether the score is high enough to be considered a reliable match.</p>\n</li>\n</ul>\n<p>For cases where you have relatively unique organization names or full affiliation strings, use the <a href=\"#affiliation-parameter-approach\" target=\"\" title=\"\">affiliation parameter approach</a>. Works for both English and non-English name variations. Examples:</p>\n<ul>\n<li>Incorporated Research Institutions for Seismology (IRIS)</li>\n<li>Universitätsbibliothek der Ludwig-Maximilians-Universität München</li>\n<li>Department of Civil and Industrial Engineering, University of Pisa, Largo Lucio Lazzarino 2, Pisa 56126, Italy</li>\n</ul>\n<p>For cases where you have very common organization names, use the <a href=\"#query-parameter-approach\" target=\"\" title=\"\">query parameter approach</a> to look for keywords from the organization&#x27;s name or the exact name of the organization surrounded by double quotation marks, and consider using filters for organization type and country. Examples:</p>\n<ul>\n<li>Ministry of Health</li>\n<li>National Research Council</li>\n<li>York University</li>\n</ul>\n<blockquote class=\"callout callout_info\" theme=\"📘\"><h2 class=\"callout-heading\"><span class=\"callout-icon\">📘</span><p>Retrieving active and inactive organizations</p></h2><p>By default, both the affiliation parameter and the query parameter will return only records with an active <a href=\"/docs/data-structure#status\" target=\"\" title=\"\" class=\"doc-link\" data-sidebar=\"data-structure#status\">status</a>: <button aria-label=\"Copy Code\" class=\"rdmd-code-copy fa\"></button><code class=\"rdmd-code lang- theme-light\" data-lang=\"\" name=\"\" tabindex=\"0\">status: &quot;active&quot;</code>. Consider whether you also want to retrieve records with an inactive status; inactive records generally represent organizations that no longer operate. See <a href=\"/docs/api-filtering\" target=\"\" title=\"\" class=\"doc-link\" data-sidebar=\"api-filtering\">API filtering</a> for details. </p><p>Be aware too that inactive organizations may be succeeded by a new organization under a different name with a different ROR ID. If you do retrieve inactive organizations, check the <button aria-label=\"Copy Code\" class=\"rdmd-code-copy fa\"></button><code class=\"rdmd-code lang- theme-light\" data-lang=\"\" name=\"\" tabindex=\"0\">relationships</code> field of an inactive record to see if it has a <a href=\"/docs/data-structure#relationships\" target=\"\" title=\"\" class=\"doc-link\" data-sidebar=\"data-structure#relationships\">Successor organization</a>.</p></blockquote>\n<h3 class=\"heading heading-3 header-scroll\" align=\"\"><div class=\"heading-anchor anchor waypoint\" id=\"affiliation-parameter-approach\"></div><div class=\"heading-text\"><div id=\"section-affiliation-parameter-approach\" class=\"heading-anchor_backwardsCompatibility\"></div>Affiliation parameter approach</div><a aria-label=\"Skip link to Affiliation parameter approach\" class=\"heading-anchor-icon fa fa-anchor\" href=\"#affiliation-parameter-approach\"></a></h3>\n<p>Searches <button aria-label=\"Copy Code\" class=\"rdmd-code-copy fa\"></button><code class=\"rdmd-code lang- theme-light\" data-lang=\"\" name=\"\" tabindex=\"0\">name</code>, <button aria-label=\"Copy Code\" class=\"rdmd-code-copy fa\"></button><code class=\"rdmd-code lang- theme-light\" data-lang=\"\" name=\"\" tabindex=\"0\">aliases</code> and <button aria-label=\"Copy Code\" class=\"rdmd-code-copy fa\"></button><code class=\"rdmd-code lang- theme-light\" data-lang=\"\" name=\"\" tabindex=\"0\">labels</code> fields using different search algorithms and returns the best match(es) based on matching score using the format <button aria-label=\"Copy Code\" class=\"rdmd-code-copy fa\"></button><code class=\"rdmd-code lang- theme-light\" data-lang=\"\" name=\"\" tabindex=\"0\">https://api.ror.org/organizations?affiliation=&lt;URL-encoded string&gt;</code>. For the full list of fields returned, see <a href=\"/docs/fields\" target=\"\" title=\"\" class=\"doc-link\" data-sidebar=\"fields\">Fields and sub-fields</a>.</p>\n<div class=\"CodeTabs CodeTabs_initial theme-light\"><div class=\"CodeTabs-toolbar\" role=\"tablist\"><button aria-selected=\"true\" class=\"CodeTabs_active\" role=\"tab\" type=\"button\">cURL</button></div><div class=\"CodeTabs-inner\" role=\"tabpanel\"><pre><button aria-label=\"Copy Code\" class=\"rdmd-code-copy fa\"></button><code class=\"rdmd-code lang-curl theme-light\" data-lang=\"curl\" name=\"\" tabindex=\"0\">curl &#x27;https://api.ror.org/v1/organizations?affiliation=university+of+wisconsin+madison&#x27; | json_pp\n</code></pre></div></div>\n<p>If there&#x27;s a high-confidence match, it will appear as the first result, with <button aria-label=\"Copy Code\" class=\"rdmd-code-copy fa\"></button><code class=\"rdmd-code lang- theme-light\" data-lang=\"\" name=\"\" tabindex=\"0\">&quot;chosen&quot;: true</code>. Other results and their matching score will also be returned, but if you&#x27;re automating this process using a script, we recommend using results with <button aria-label=\"Copy Code\" class=\"rdmd-code-copy fa\"></button><code class=\"rdmd-code lang- theme-light\" data-lang=\"\" name=\"\" tabindex=\"0\">&quot;chosen&quot;: true</code> rather than relying on the score. Results are paginated: see <a href=\"/docs/api-paging\" target=\"\" title=\"\" class=\"doc-link\" data-sidebar=\"api-paging\">API paging</a> for details.</p>\n<div class=\"CodeTabs CodeTabs_initial theme-light\"><div class=\"CodeTabs-toolbar\" role=\"tablist\"><button aria-selected=\"true\" class=\"CodeTabs_active\" role=\"tab\" type=\"button\">JSON</button></div><div class=\"CodeTabs-inner\" role=\"tabpanel\"><pre><button aria-label=\"Copy Code\" class=\"rdmd-code-copy fa\"></button><code class=\"rdmd-code lang-json theme-light\" data-lang=\"json\" name=\"\" tabindex=\"0\">{\n &quot;items&quot; : [\n {\n &quot;chosen&quot; : true,\n &quot;matching_type&quot; : &quot;EXACT&quot;,\n &quot;organization&quot; : {\n &quot;acronyms&quot; : [\n &quot;UW&quot;\n ],\n &quot;addresses&quot; : [\n {\n &quot;city&quot; : &quot;Madison&quot;,\n &quot;country_geonames_id&quot; : null,\n &quot;geonames_city&quot; : {\n &quot;city&quot; : &quot;Madison&quot;,\n &quot;geonames_admin1&quot; : {\n &quot;ascii_name&quot; : null,\n &quot;code&quot; : &quot;US.WI&quot;,\n &quot;id&quot; : null,\n &quot;name&quot; : &quot;Wisconsin&quot;\n },\n &quot;geonames_admin2&quot; : {\n &quot;ascii_name&quot; : null,\n &quot;code&quot; : null,\n &quot;id&quot; : null,\n &quot;name&quot; : null\n },\n &quot;id&quot; : 5261457,\n &quot;license&quot; : {\n &quot;attribution&quot; : &quot;Data from geonames.org under a CC-BY 3.0 license&quot;,\n &quot;license&quot; : &quot;http://creativecommons.org/licenses/by/3.0/&quot;\n },\n &quot;nuts_level1&quot; : {\n &quot;code&quot; : null,\n &quot;name&quot; : null\n },\n &quot;nuts_level2&quot; : {\n &quot;code&quot; : null,\n &quot;name&quot; : null\n },\n &quot;nuts_level3&quot; : {\n &quot;code&quot; : null,\n &quot;name&quot; : null\n }\n },\n &quot;lat&quot; : 43.07305,\n &quot;line&quot; : null,\n &quot;lng&quot; : -89.40123,\n &quot;postcode&quot; : null,\n &quot;primary&quot; : false,\n &quot;state&quot; : null,\n &quot;state_code&quot; : null\n }\n ],\n &quot;aliases&quot; : [\n &quot;UW–Madison&quot;\n ],\n &quot;country&quot; : {\n &quot;country_code&quot; : &quot;US&quot;,\n &quot;country_name&quot; : &quot;United States&quot;\n },\n &quot;email_address&quot; : null,\n &quot;established&quot; : 1848,\n &quot;external_ids&quot; : {\n &quot;FundRef&quot; : {\n &quot;all&quot; : [\n &quot;100007015&quot;,\n &quot;100008959&quot;,\n &quot;100005996&quot;,\n &quot;100007870&quot;,\n &quot;100008301&quot;,\n &quot;100008028&quot;,\n &quot;100008237&quot;,\n &quot;100008161&quot;,\n &quot;100010495&quot;,\n &quot;100009627&quot;,\n &quot;100010284&quot;,\n &quot;100005911&quot;,\n &quot;100007925&quot;,\n &quot;100005902&quot;,\n &quot;100012787&quot;\n ],\n &quot;preferred&quot; : &quot;100007015&quot;\n },\n &quot;GRID&quot; : {\n &quot;all&quot; : &quot;grid.14003.36&quot;,\n &quot;preferred&quot; : &quot;grid.14003.36&quot;\n },\n &quot;ISNI&quot; : {\n &quot;all&quot; : [\n &quot;0000 0001 2167 3675&quot;\n ],\n &quot;preferred&quot; : null\n },\n &quot;Wikidata&quot; : {\n &quot;all&quot; : [\n &quot;Q838330&quot;,\n &quot;Q33122195&quot;,\n &quot;Q7662222&quot;\n ],\n &quot;preferred&quot; : &quot;Q838330&quot;\n }\n },\n &quot;id&quot; : &quot;https://ror.org/01y2jtd41&quot;,\n &quot;ip_addresses&quot; : [],\n &quot;labels&quot; : [\n {\n &quot;iso639&quot; : &quot;es&quot;,\n &quot;label&quot; : &quot;Universidad de Wisconsin-Madison&quot;\n },\n {\n &quot;iso639&quot; : &quot;fr&quot;,\n &quot;label&quot; : &quot;Université du Wisconsin à Madison&quot;\n }\n ],\n &quot;links&quot; : [\n &quot;http://www.wisc.edu/&quot;\n ],\n &quot;name&quot; : &quot;University of Wisconsin–Madison&quot;,\n &quot;relationships&quot; : [\n {\n &quot;id&quot; : &quot;https://ror.org/05cb4rb43&quot;,\n &quot;label&quot; : &quot;Morgridge Institute for Research&quot;,\n &quot;type&quot; : &quot;Child&quot;\n },\n {\n &quot;id&quot; : &quot;https://ror.org/04gq8q482&quot;,\n &quot;label&quot; : &quot;North Temperate Lakes Long Term Ecological Research&quot;,\n &quot;type&quot; : &quot;Child&quot;\n },\n {\n &quot;id&quot; : &quot;https://ror.org/03ydkyb10&quot;,\n &quot;label&quot; : &quot;University of Wisconsin System&quot;,\n &quot;type&quot; : &quot;Parent&quot;\n },\n {\n &quot;id&quot; : &quot;https://ror.org/03b8vas82&quot;,\n &quot;label&quot; : &quot;National Atmospheric Deposition Program&quot;,\n &quot;type&quot; : &quot;Related&quot;\n },\n {\n &quot;id&quot; : &quot;https://ror.org/04r3s7465&quot;,\n &quot;label&quot; : &quot;McMurdo Dry Valleys Long Term Ecological Research&quot;,\n &quot;type&quot; : &quot;Related&quot;\n },\n {\n &quot;id&quot; : &quot;https://ror.org/02kj3rm24&quot;,\n &quot;label&quot; : &quot;Wisconsin Geological and Natural History Survey&quot;,\n &quot;type&quot; : &quot;Child&quot;\n }\n ],\n &quot;status&quot; : &quot;active&quot;,\n &quot;types&quot; : [\n &quot;Education&quot;,\n &quot;Funder&quot;\n ],\n &quot;wikipedia_url&quot; : &quot;http://en.wikipedia.org/wiki/University_of_Wisconsin%E2%80%93Madison&quot;\n },\n &quot;score&quot; : 1,\n &quot;substring&quot; : &quot;university of wisconsin madison&quot;\n },\n {\n &quot;chosen&quot; : false,\n &quot;matching_type&quot; : &quot;EXACT&quot;,\n &quot;organization&quot; : {\n &quot;acronyms&quot; : [\n &quot;UWHC&quot;\n ],\n &quot;addresses&quot; : [\n {\n &quot;city&quot; : &quot;Madison&quot;,\n &quot;country_geonames_id&quot; : null,\n &quot;geonames_city&quot; : {\n &quot;city&quot; : &quot;Madison&quot;,\n &quot;geonames_admin1&quot; : {\n &quot;ascii_name&quot; : null,\n &quot;code&quot; : &quot;US.WI&quot;,\n &quot;id&quot; : null,\n &quot;name&quot; : &quot;Wisconsin&quot;\n },\n &quot;geonames_admin2&quot; : {\n &quot;ascii_name&quot; : null,\n &quot;code&quot; : null,\n &quot;id&quot; : null,\n &quot;name&quot; : null\n },\n &quot;id&quot; : 5261457,\n &quot;license&quot; : {\n &quot;attribution&quot; : &quot;Data from geonames.org under a CC-BY 3.0 license&quot;,\n &quot;license&quot; : &quot;http://creativecommons.org/licenses/by/3.0/&quot;\n },\n &quot;nuts_level1&quot; : {\n &quot;code&quot; : null,\n &quot;name&quot; : null\n },\n &quot;nuts_level2&quot; : {\n &quot;code&quot; : null,\n &quot;name&quot; : null\n },\n &quot;nuts_level3&quot; : {\n &quot;code&quot; : null,\n &quot;name&quot; : null\n }\n },\n &quot;lat&quot; : 43.07305,\n &quot;line&quot; : null,\n &quot;lng&quot; : -89.40123,\n &quot;postcode&quot; : null,\n &quot;primary&quot; : false,\n &quot;state&quot; : null,\n &quot;state_code&quot; : null\n }\n ],\n &quot;aliases&quot; : [\n &quot;UW Hospital and Clinics&quot;,\n &quot;University of Wisconsin Health University Hospital&quot;,\n &quot;University of Wisconsin Hospital and Clinics&quot;,\n &quot;University of Wisconsin-Madison Hospital&quot;,\n &quot;Wisconsin General Hospital&quot;\n ],\n &quot;country&quot; : {\n &quot;country_code&quot; : &quot;US&quot;,\n &quot;country_name&quot; : &quot;United States&quot;\n },\n &quot;email_address&quot; : null,\n &quot;established&quot; : 1924,\n &quot;external_ids&quot; : {\n &quot;GRID&quot; : {\n &quot;all&quot; : &quot;grid.412647.2&quot;,\n &quot;preferred&quot; : &quot;grid.412647.2&quot;\n },\n &quot;ISNI&quot; : {\n &quot;all&quot; : [\n &quot;0000 0000 9209 0955&quot;\n ],\n &quot;preferred&quot; : null\n },\n &quot;Wikidata&quot; : {\n &quot;all&quot; : [\n &quot;Q7896631&quot;\n ],\n &quot;preferred&quot; : null\n }\n },\n &quot;id&quot; : &quot;https://ror.org/02mqqhj42&quot;,\n &quot;ip_addresses&quot; : [],\n &quot;labels&quot; : [],\n &quot;links&quot; : [\n &quot;https://www.uwhealth.org/locations/university-hospital-170&quot;\n ],\n &quot;name&quot; : &quot;UW Health University Hospital&quot;,\n &quot;relationships&quot; : [\n {\n &quot;id&quot; : &quot;https://ror.org/01e4byj08&quot;,\n &quot;label&quot; : &quot;University of Wisconsin Carbone Cancer Center&quot;,\n &quot;type&quot; : &quot;Child&quot;\n },\n {\n &quot;id&quot; : &quot;https://ror.org/03e3qgk42&quot;,\n &quot;label&quot; : &quot;University of Wisconsin Health&quot;,\n &quot;type&quot; : &quot;Parent&quot;\n }\n ],\n &quot;status&quot; : &quot;active&quot;,\n &quot;types&quot; : [\n &quot;Healthcare&quot;\n ],\n &quot;wikipedia_url&quot; : &quot;https://en.wikipedia.org/wiki/University_of_Wisconsin_Hospital_and_Clinics&quot;\n },\n &quot;score&quot; : 0.87,\n &quot;substring&quot; : &quot;university of wisconsin madison&quot;\n },\n {\n &quot;chosen&quot; : false,\n &quot;matching_type&quot; : &quot;EXACT&quot;,\n &quot;organization&quot; : {\n &quot;acronyms&quot; : [\n &quot;UWCCC&quot;\n ],\n &quot;addresses&quot; : [\n {\n &quot;city&quot; : &quot;Madison&quot;,\n &quot;country_geonames_id&quot; : null,\n &quot;geonames_city&quot; : {\n &quot;city&quot; : &quot;Madison&quot;,\n &quot;geonames_admin1&quot; : {\n &quot;ascii_name&quot; : null,\n &quot;code&quot; : &quot;US.WI&quot;,\n &quot;id&quot; : null,\n &quot;name&quot; : &quot;Wisconsin&quot;\n },\n &quot;geonames_admin2&quot; : {\n &quot;ascii_name&quot; : null,\n &quot;code&quot; : null,\n &quot;id&quot; : null,\n &quot;name&quot; : null\n },\n &quot;id&quot; : 5261457,\n &quot;license&quot; : {\n &quot;attribution&quot; : &quot;Data from geonames.org under a CC-BY 3.0 license&quot;,\n &quot;license&quot; : &quot;http://creativecommons.org/licenses/by/3.0/&quot;\n },\n &quot;nuts_level1&quot; : {\n &quot;code&quot; : null,\n &quot;name&quot; : null\n },\n &quot;nuts_level2&quot; : {\n &quot;code&quot; : null,\n &quot;name&quot; : null\n },\n &quot;nuts_level3&quot; : {\n &quot;code&quot; : null,\n &quot;name&quot; : null\n }\n },\n &quot;lat&quot; : 43.07305,\n &quot;line&quot; : null,\n &quot;lng&quot; : -89.40123,\n &quot;postcode&quot; : null,\n &quot;primary&quot; : false,\n &quot;state&quot; : null,\n &quot;state_code&quot; : null\n }\n ],\n &quot;aliases&quot; : [\n &quot;Carbone Cancer Center&quot;,\n &quot;UW Carbone&quot;,\n &quot;UW Carbone Cancer Center&quot;,\n &quot;UW Carbone Comprehensive Cancer Center&quot;,\n &quot;UWCCC Madison&quot;,\n &quot;University of Wisconsin Cancer Center&quot;,\n &quot;University of Wisconsin Carbone Comprehensive Cancer Center&quot;,\n &quot;University of Wisconsin Comprehensive Cancer Center&quot;,\n &quot;University of Wisconsin-Madison Carbone Cancer Center&quot;\n ],\n &quot;country&quot; : {\n &quot;country_code&quot; : &quot;US&quot;,\n &quot;country_name&quot; : &quot;United States&quot;\n },\n &quot;email_address&quot; : null,\n &quot;established&quot; : 1940,\n &quot;external_ids&quot; : {\n &quot;FundRef&quot; : {\n &quot;all&quot; : [\n &quot;100007923&quot;\n ],\n &quot;preferred&quot; : &quot;100007923&quot;\n },\n &quot;GRID&quot; : {\n &quot;all&quot; : &quot;grid.412639.b&quot;,\n &quot;preferred&quot; : &quot;grid.412639.b&quot;\n },\n &quot;ISNI&quot; : {\n &quot;all&quot; : [\n &quot;0000 0001 2191 1477&quot;\n ],\n &quot;preferred&quot; : null\n },\n &quot;Wikidata&quot; : {\n &quot;all&quot; : [\n &quot;Q7876154&quot;\n ],\n &quot;preferred&quot; : null\n }\n },\n &quot;id&quot; : &quot;https://ror.org/01e4byj08&quot;,\n &quot;ip_addresses&quot; : [],\n &quot;labels&quot; : [],\n &quot;links&quot; : [\n &quot;https://cancer.wisc.edu&quot;\n ],\n &quot;name&quot; : &quot;University of Wisconsin Carbone Cancer Center&quot;,\n &quot;relationships&quot; : [\n {\n &quot;id&quot; : &quot;https://ror.org/02mqqhj42&quot;,\n &quot;label&quot; : &quot;UW Health University Hospital&quot;,\n &quot;type&quot; : &quot;Parent&quot;\n }\n ],\n &quot;status&quot; : &quot;active&quot;,\n &quot;types&quot; : [\n &quot;Funder&quot;,\n &quot;Healthcare&quot;\n ],\n &quot;wikipedia_url&quot; : &quot;https://en.wikipedia.org/wiki/University_of_Wisconsin_Carbone_Cancer_Center&quot;\n },\n &quot;score&quot; : 0.76,\n &quot;substring&quot; : &quot;university of wisconsin madison&quot;\n }\n ],\n &quot;number_of_results&quot; : 3\n}\n</code></pre></div></div>\n<blockquote class=\"callout callout_warn\" theme=\"🚧\"><h2 class=\"callout-heading\"><span class=\"callout-icon\">🚧</span><p>Don&#x27;t automatically select the first &quot;unchosen&quot; result of an ?affiliation query with no <button aria-label=\"Copy Code\" class=\"rdmd-code-copy fa\"></button><code class=\"rdmd-code lang- theme-light\" data-lang=\"\" name=\"\" tabindex=\"0\">chosen: true</code> result</p></h2><p>When no result has <button aria-label=\"Copy Code\" class=\"rdmd-code-copy fa\"></button><code class=\"rdmd-code lang- theme-light\" data-lang=\"\" name=\"\" tabindex=\"0\">&quot;chosen&quot;: true</code>, the first result is not necessarily the best match for a given affiliation string. In that case, several results may have the exact same score and/or there may be no match with a high score. Because the affiliation service breaks a given affiliation string into multiple substrings and performs searches of each substring on its own as well as in combination with other substrings, a high scoring match that is not selected as chosen may be a match to only a small portion of the entire affiliation string. In these cases, it is best to respect the absence of <button aria-label=\"Copy Code\" class=\"rdmd-code-copy fa\"></button><code class=\"rdmd-code lang- theme-light\" data-lang=\"\" name=\"\" tabindex=\"0\">&quot;chosen: true&quot;</code> and leave the string unmatched or add a layer of human or machine assignment, at your discretion.</p></blockquote>\n<h4 class=\"heading heading-4 header-scroll\" align=\"\"><div class=\"heading-anchor anchor waypoint\" id=\"additional-request-examples\"></div><div class=\"heading-text\"><div id=\"section-additional-request-examples\" class=\"heading-anchor_backwardsCompatibility\"></div>Additional request examples:</div><a aria-label=\"Skip link to Additional request examples:\" class=\"heading-anchor-icon fa fa-anchor\" href=\"#additional-request-examples\"></a></h4>\n<p>Incorporated Research Institutions for Seismology (IRIS)</p>\n<div class=\"CodeTabs CodeTabs_initial theme-light\"><div class=\"CodeTabs-toolbar\" role=\"tablist\"><button aria-selected=\"true\" class=\"CodeTabs_active\" role=\"tab\" type=\"button\">cURL</button></div><div class=\"CodeTabs-inner\" role=\"tabpanel\"><pre><button aria-label=\"Copy Code\" class=\"rdmd-code-copy fa\"></button><code class=\"rdmd-code lang-curl theme-light\" data-lang=\"curl\" name=\"\" tabindex=\"0\">curl &#x27;https://api.ror.org/v1/organizations?affiliation=Incorporated%20Research%20Institutions%20for%20Seismology%20(IRIS)&#x27; | json_pp\n</code></pre></div></div>\n<p>Universitätsbibliothek der Ludwig-Maximilians-Universität München</p>\n<div class=\"CodeTabs CodeTabs_initial theme-light\"><div class=\"CodeTabs-toolbar\" role=\"tablist\"><button aria-selected=\"true\" class=\"CodeTabs_active\" role=\"tab\" type=\"button\">cURL</button></div><div class=\"CodeTabs-inner\" role=\"tabpanel\"><pre><button aria-label=\"Copy Code\" class=\"rdmd-code-copy fa\"></button><code class=\"rdmd-code lang-curl theme-light\" data-lang=\"curl\" name=\"\" tabindex=\"0\">curl &#x27;https://api.ror.org/v1/organizations?affiliation=Universit%C3%A4tsbibliothek%20der%20Ludwig-Maximilians-Universit%C3%A4t%20M%C3%BCnchen&#x27; | json_pp\n</code></pre></div></div>\n<p>Department of Civil and Industrial Engineering, University of Pisa, Largo Lucio Lazzarino 2, Pisa 56126, Italy</p>\n<div class=\"CodeTabs CodeTabs_initial theme-light\"><div class=\"CodeTabs-toolbar\" role=\"tablist\"><button aria-selected=\"true\" class=\"CodeTabs_active\" role=\"tab\" type=\"button\">cURL</button></div><div class=\"CodeTabs-inner\" role=\"tabpanel\"><pre><button aria-label=\"Copy Code\" class=\"rdmd-code-copy fa\"></button><code class=\"rdmd-code lang-curl theme-light\" data-lang=\"curl\" name=\"\" tabindex=\"0\">curl &#x27;https://api.ror.org/v1/organizations?affiliation=Department%20of%20Civil%20and%20Industrial%20Engineering%2C%20University%20of%20Pisa%2C%20Largo%20Lucio%20Lazzarino%202%2C%20Pisa%2056126%2C%20Italy&#x27; | json_pp\n</code></pre></div></div>\n<h3 class=\"heading heading-3 header-scroll\" align=\"\"><div class=\"heading-anchor anchor waypoint\" id=\"query-parameter-approach\"></div><div class=\"heading-text\"><div id=\"section-query-parameter-approach\" class=\"heading-anchor_backwardsCompatibility\"></div>Query parameter approach</div><a aria-label=\"Skip link to Query parameter approach\" class=\"heading-anchor-icon fa fa-anchor\" href=\"#query-parameter-approach\"></a></h3>\n<p>Search all indexed fields in ROR records using the format <button aria-label=\"Copy Code\" class=\"rdmd-code-copy fa\"></button><code class=\"rdmd-code lang- theme-light\" data-lang=\"\" name=\"\" tabindex=\"0\">https://api.ror.org/organizations?query=&lt;search term&gt;&amp;filter=&lt;filters&gt;</code>. We strongly recommend using <a href=\"/docs/filtering\" target=\"\" title=\"\" class=\"doc-link\" data-sidebar=\"filtering\">organization type and country filters</a>. For more information, see the <a href=\"/docs/rest-api\" target=\"\" title=\"\" class=\"doc-link\" data-sidebar=\"rest-api\">REST API guide</a>.</p>\n<div class=\"CodeTabs CodeTabs_initial theme-light\"><div class=\"CodeTabs-toolbar\" role=\"tablist\"><button aria-selected=\"true\" class=\"CodeTabs_active\" role=\"tab\" type=\"button\">cURL</button></div><div class=\"CodeTabs-inner\" role=\"tabpanel\"><pre><button aria-label=\"Copy Code\" class=\"rdmd-code-copy fa\"></button><code class=\"rdmd-code lang-curl theme-light\" data-lang=\"curl\" name=\"\" tabindex=\"0\">curl &#x27;https://api.ror.org/v1/organizations?query=%22Ministry+of+Health%22&amp;filter=types:Government,country.country_code:NZ&#x27; | json_pp\n</code></pre></div></div>\n<p>The response is a JSON object containing full records for the first 20 search results. Results are paginated: see <a href=\"/docs/api-paging\" target=\"\" title=\"\" class=\"doc-link\" data-sidebar=\"api-paging\">API paging</a> for details. Matching scores are not included, but closest matches are at the beginning of the list. </p>\n<blockquote class=\"callout callout_info\" theme=\"📘\"><h2 class=\"callout-heading\"><span class=\"callout-icon\">📘</span><p>Query parameter searches may return many results, so some amount of human intervention may be needed to determine the matching ROR ID (if there is one).</p></h2></blockquote>\n<div class=\"CodeTabs CodeTabs_initial theme-light\"><div class=\"CodeTabs-toolbar\" role=\"tablist\"><button aria-selected=\"true\" class=\"CodeTabs_active\" role=\"tab\" type=\"button\">cURL</button></div><div class=\"CodeTabs-inner\" role=\"tabpanel\"><pre><button aria-label=\"Copy Code\" class=\"rdmd-code-copy fa\"></button><code class=\"rdmd-code lang-curl theme-light\" data-lang=\"curl\" name=\"\" tabindex=\"0\">{\n &quot;items&quot; : [\n {\n &quot;acronyms&quot; : [],\n &quot;addresses&quot; : [\n {\n &quot;city&quot; : &quot;Wellington&quot;,\n &quot;country_geonames_id&quot; : null,\n &quot;geonames_city&quot; : {\n &quot;city&quot; : &quot;Wellington&quot;,\n &quot;geonames_admin1&quot; : {\n &quot;ascii_name&quot; : null,\n &quot;code&quot; : &quot;NZ.WGN&quot;,\n &quot;id&quot; : null,\n &quot;name&quot; : &quot;Wellington Region&quot;\n },\n &quot;geonames_admin2&quot; : {\n &quot;ascii_name&quot; : null,\n &quot;code&quot; : null,\n &quot;id&quot; : null,\n &quot;name&quot; : null\n },\n &quot;id&quot; : 2179537,\n &quot;license&quot; : {\n &quot;attribution&quot; : &quot;Data from geonames.org under a CC-BY 3.0 license&quot;,\n &quot;license&quot; : &quot;http://creativecommons.org/licenses/by/3.0/&quot;\n },\n &quot;nuts_level1&quot; : {\n &quot;code&quot; : null,\n &quot;name&quot; : null\n },\n &quot;nuts_level2&quot; : {\n &quot;code&quot; : null,\n &quot;name&quot; : null\n },\n &quot;nuts_level3&quot; : {\n &quot;code&quot; : null,\n &quot;name&quot; : null\n }\n },\n &quot;lat&quot; : -41.28664,\n &quot;line&quot; : null,\n &quot;lng&quot; : 174.77557,\n &quot;postcode&quot; : null,\n &quot;primary&quot; : false,\n &quot;state&quot; : null,\n &quot;state_code&quot; : null\n }\n ],\n &quot;aliases&quot; : [\n &quot;Manatū Hauora&quot;\n ],\n &quot;country&quot; : {\n &quot;country_code&quot; : &quot;NZ&quot;,\n &quot;country_name&quot; : &quot;New Zealand&quot;\n },\n &quot;email_address&quot; : null,\n &quot;established&quot; : 1903,\n &quot;external_ids&quot; : {\n &quot;FundRef&quot; : {\n &quot;all&quot; : [\n &quot;501100001504&quot;\n ],\n &quot;preferred&quot; : null\n },\n &quot;GRID&quot; : {\n &quot;all&quot; : &quot;grid.415708.f&quot;,\n &quot;preferred&quot; : &quot;grid.415708.f&quot;\n },\n &quot;ISNI&quot; : {\n &quot;all&quot; : [\n &quot;0000 0004 0483 5988&quot;\n ],\n &quot;preferred&quot; : null\n },\n &quot;Wikidata&quot; : {\n &quot;all&quot; : [\n &quot;Q16933991&quot;\n ],\n &quot;preferred&quot; : null\n }\n },\n &quot;id&quot; : &quot;https://ror.org/00vjb5165&quot;,\n &quot;ip_addresses&quot; : [],\n &quot;labels&quot; : [],\n &quot;links&quot; : [\n &quot;http://www.health.govt.nz/&quot;\n ],\n &quot;name&quot; : &quot;Ministry of Health&quot;,\n &quot;relationships&quot; : [],\n &quot;status&quot; : &quot;active&quot;,\n &quot;types&quot; : [\n &quot;Government&quot;,\n &quot;Funder&quot;\n ],\n &quot;wikipedia_url&quot; : &quot;https://en.wikipedia.org/wiki/Ministry_of_Health_(New_Zealand)&quot;\n }\n ],\n &quot;meta&quot; : {\n &quot;countries&quot; : [\n {\n &quot;count&quot; : 1,\n &quot;id&quot; : &quot;nz&quot;,\n &quot;title&quot; : &quot;New Zealand&quot;\n }\n ],\n &quot;statuses&quot; : [\n {\n &quot;count&quot; : 1,\n &quot;id&quot; : &quot;active&quot;,\n &quot;title&quot; : &quot;active&quot;\n }\n ],\n &quot;types&quot; : [\n {\n &quot;count&quot; : 1,\n &quot;id&quot; : &quot;funder&quot;,\n &quot;title&quot; : &quot;Funder&quot;\n },\n {\n &quot;count&quot; : 1,\n &quot;id&quot; : &quot;government&quot;,\n &quot;title&quot; : &quot;Government&quot;\n }\n ]\n },\n &quot;number_of_results&quot; : 1,\n &quot;time_taken&quot; : 6\n}\n</code></pre></div></div>\n<h2 class=\"heading heading-2 header-scroll\" align=\"\"><div class=\"heading-anchor anchor waypoint\" id=\"matching-a-list-of-organization-names-to-ror-ids-using-a-script\"></div><div class=\"heading-text\"><div id=\"section-matching-a-list-of-organization-names-to-ror-i-ds-using-a-script\" class=\"heading-anchor_backwardsCompatibility\"></div>Matching a list of organization names to ROR IDs using a script</div><a aria-label=\"Skip link to Matching a list of organization names to ROR IDs using a script\" class=\"heading-anchor-icon fa fa-anchor\" href=\"#matching-a-list-of-organization-names-to-ror-ids-using-a-script\"></a></h2>\n<p>You can write your own script to match a list of organization names to ROR IDs via the ROR API, though some manual intervention will likely be needed to make sure that matches are correct. If you are writing a script, remember the following:</p>\n<ul>\n<li>Try the <a href=\"#affiliation-parameter-approach\" target=\"\" title=\"\">affiliation parameter approach</a> first instead of the <a href=\"#query-parameter-approach\" target=\"\" title=\"\">query parameter approach</a>.</li>\n<li>Look for &quot;chosen&quot; results where <button aria-label=\"Copy Code\" class=\"rdmd-code-copy fa\"></button><code class=\"rdmd-code lang- theme-light\" data-lang=\"\" name=\"\" tabindex=\"0\">&quot;chosen&quot;: true</code>. </li>\n<li>If no results are found, try alternate names/acronyms (if you have them) or try the query parameter approach. </li>\n<li>API results are paginated: see <a href=\"#api-paging\" target=\"\" title=\"\">API paging</a> for details.</li>\n<li>By default, API requests will return only records with an active <a href=\"/docs/data-structure#status\" target=\"\" title=\"\" class=\"doc-link\" data-sidebar=\"data-structure#status\">status</a>: <button aria-label=\"Copy Code\" class=\"rdmd-code-copy fa\"></button><code class=\"rdmd-code lang- theme-light\" data-lang=\"\" name=\"\" tabindex=\"0\">status: &quot;active&quot;</code>. Consider whether you want to retrieve records with an inactive status as well; inactive records generally represent organizations that no longer operate. See <a href=\"/docs/api-filtering\" target=\"\" title=\"\" class=\"doc-link\" data-sidebar=\"api-filtering\">API filtering</a> for details. </li>\n</ul>\n<p>See, use, and clone examples of Python scripts that match organization names to ROR IDs in the <a href=\"https://github.com/ror-community/ror-utilities\" target=\"\" title=\"\">ror-utilities Github repository</a>.</p>\n<h2 class=\"heading heading-2 header-scroll\" align=\"\"><div class=\"heading-anchor anchor waypoint\" id=\"match-organization-names-to-ror-ids-using-the-data-dump\"></div><div class=\"heading-text\"><div id=\"section-match-organization-names-to-ror-i-ds-using-the-data-dump\" class=\"heading-anchor_backwardsCompatibility\"></div>Match organization names to ROR IDs using the data dump</div><a aria-label=\"Skip link to Match organization names to ROR IDs using the data dump\" class=\"heading-anchor-icon fa fa-anchor\" href=\"#match-organization-names-to-ror-ids-using-the-data-dump\"></a></h2>\n<p>Instead of using the ROR API, you can use your own scripts or processing tools on the <a href=\"/docs/data-dump\" target=\"\" title=\"\" class=\"doc-link\" data-sidebar=\"data-dump\">ROR data dump</a> to match organization names to ROR IDs. Advantages of this approach include:</p>\n<ul>\n<li>Fine-grained control over matching criteria</li>\n<li>Faster processing in cases where you have many IDs to map</li>\n<li>No chance of error responses due to network interruptions or API outages</li>\n</ul>\n<h2 class=\"heading heading-2 header-scroll\" align=\"\"><div class=\"heading-anchor anchor waypoint\" id=\"match-organization-names-to-ror-using-openrefine\"></div><div class=\"heading-text\"><div id=\"section-match-organization-names-to-ror-using-open-refine\" class=\"heading-anchor_backwardsCompatibility\"></div>Match organization names to ROR using OpenRefine</div><a aria-label=\"Skip link to Match organization names to ROR using OpenRefine\" class=\"heading-anchor-icon fa fa-anchor\" href=\"#match-organization-names-to-ror-using-openrefine\"></a></h2>\n<p>The <strong>ROR OpenRefine Reconciler</strong> is a fairly labor-intensive way of matching organization names to ROR IDs, but it works well for those who have a relatively small list of organization names, those who want to have a high degree of control and oversight over the matching process, and those who do not want to write code. </p>\n<p><a href=\"https://openrefine.org\" target=\"\" title=\"\">OpenRefine</a> (formerly Google Refine) is a free, open source desktop tool for cleaning up messy data stored in common formats like CSV, JSON, XML, XLS. You can even use it to connect to SQL-based databases and Google Sheets. </p>\n<p>See <a href=\"/docs/openrefine-reconciler\" target=\"\" title=\"\" class=\"doc-link\" data-sidebar=\"openrefine-reconciler\">ROR OpenRefine Reconciler</a> for written usage instructions, screenshots, and a tutorial video. </p>\n<h2 class=\"heading heading-2 header-scroll\" align=\"\"><div class=\"heading-anchor anchor waypoint\" id=\"match-organization-names-to-ror-ids-using-third-party-tools\"></div><div class=\"heading-text\"><div id=\"section-match-organization-names-to-ror-i-ds-using-third-party-tools\" class=\"heading-anchor_backwardsCompatibility\"></div>Match organization names to ROR IDs using third-party tools</div><a aria-label=\"Skip link to Match organization names to ROR IDs using third-party tools\" class=\"heading-anchor-icon fa fa-anchor\" href=\"#match-organization-names-to-ror-ids-using-third-party-tools\"></a></h2>\n<p>Several projects and researchers have developed scripts and/or machine learning and artificial intelligence tools that match textual organization information to ROR IDs. Several of these tools are fast and can work with large amounts of data with accuracy rates before human intervention ranging from about 85% to 95%. These tools are not officially supported by ROR, but we list them here in case you find them useful. </p>\n<ul>\n<li>\n<p><a href=\"https://github.com/ourresearch/openalex-institution-parsing\" target=\"\" title=\"\">OpenAlex Institution Parsing</a> by OurResearch</p>\n</li>\n<li>\n<p><a href=\"https://github.com/allenai/S2AFF/\" target=\"\" title=\"\">S2AFF - Semantic Scholar Affiliations Linker</a> by the Allen AI Institute</p>\n</li>\n<li>\n<p><a href=\"https://github.com/Metadata-Game-Changers/RORRetriever\" target=\"\" title=\"\">RORRetriever</a> by Metadata Game Changers</p>\n</li>\n<li>\n<p><a href=\"https://gitlab.ebi.ac.uk/literature-services/public-projects/ROR-proto-EMBL\" target=\"\" title=\"\">EMBL-EBI ROR Predictor prototype</a> by EMBL-EBI for <a href=\"https://www.project-freya.eu/Plone/en\" target=\"\" title=\"\">Project FREYA</a></p>\n</li>\n<li>\n<p><a href=\"https://github.com/dataesr/affiliation-matcher\" target=\"\" title=\"\">dataESR affiliation matcher</a> developed by Anne L&#x27;Hôte and Eric Jeangirard for the French Ministry of Higher Education</p>\n</li>\n<li>\n<p><a href=\"https://github.com/adambuttrick/openalex-ror-predictor\" target=\"\" title=\"\">OpenAlex ROR Predictor (gpu-based)</a> by ROR Curation Lead Adam Buttrick</p>\n</li>\n<li>\n<p><a href=\"https://github.com/adambuttrick/ror-predictor-fasttext\" target=\"\" title=\"\">fastText ROR Predictor (cpu-based)</a> by ROR Curation Lead Adam Buttrick</p>\n</li>\n<li>\n<p><a href=\"https://github.com/adambuttrick/lr_matches\" target=\"\" title=\"\">lr_predictor</a> by ROR Curation Lead Adam Buttrick</p>\n</li>\n<li>\n<p><a href=\"https://github.com/ror-community/affiliation-matching-experimental\" target=\"\" title=\"\">ROR experimental affiliation matching</a> - A collection of data and code for training models and experimenting with automatically matching affiliation strings to ROR IDs. Not production code, and not officially supported by ROR. </p>\n</li>\n</ul>\n<h2 class=\"heading heading-2 header-scroll\" align=\"\"><div class=\"heading-anchor anchor waypoint\" id=\"testing-and-training-data\"></div><div class=\"heading-text\"><div id=\"section-testing-and-training-data\" class=\"heading-anchor_backwardsCompatibility\"></div>Testing and training data</div><a aria-label=\"Skip link to Testing and training data\" class=\"heading-anchor-icon fa fa-anchor\" href=\"#testing-and-training-data\"></a></h2>\n<p>ROR is currently experimenting with strategies for automatically matching affiliation strings to ROR IDs, and we have collected sets of data from Springer Nature, the American Physical Society, Crossref, and OpenAlex for testing and training matching strategies that are openly available at <a href=\"https://github.com/ror-community/affiliation-matching-experimental/tree/main/test_data\" target=\"\" title=\"\">https://github.com/ror-community/affiliation-matching-experimental/tree/main/test_data</a>. These datasets include affiliation text strings from production systems that have been matched to ROR IDs with varying levels of human review.</p>"},"opts":{"alwaysThrow":false,"compatibilityMode":false,"copyButtons":true,"correctnewlines":false,"markdownOptions":{"fences":true,"commonmark":true,"gfm":true,"ruleSpaces":false,"listItemIndent":"1","spacedTable":true,"paddedTable":true},"normalize":true,"lazyImages":true,"reusableContent":{"tags":{}},"safeMode":false,"settings":{"position":true},"theme":"light","customBlocks":{},"resourceID":"60d3e4c27dccd0004443bc84","resourceType":"page","baseUrl":"/","terms":[{"_id":"6058e47681775f002de04833","term":"parliament","definition":"Owls are generally solitary, but when seen together the group is called a 'parliament'!"}],"variables":{"user":{},"defaults":[]}},"terms":[{"_id":"6058e47681775f002de04833","term":"parliament","definition":"Owls are generally solitary, but when seen together the group is called a 'parliament'!"}],"variables":{"user":{},"defaults":[]},"mdx":false},"doc":{"metadata":{"image":[],"title":"","description":"This document provides guidance on matching organization names to ROR IDs using the ROR API, including different approaches like the affiliation parameter and query parameter methods. It also mentions using scripts, the ROR data dump, OpenRefine, and third-party tools for this purpose.","keywords":"","robots":"index"},"mdx":{"altBody":"","status":"rdmd"},"api":{"method":"get","url":"","auth":"required","results":{"codes":[{"name":"","code":"{}","language":"json","status":200},{"name":"","code":"{}","language":"json","status":400}]},"params":[]},"next":{"description":"","pages":[{"type":"doc","icon":"file-text-o","name":"OpenRefine reconciler","slug":"openrefine-reconciler","category":"Tools & services"},{"type":"url","value":"https://youtu.be/Tx5y7lX030U","name":"Video: Strategies for Matching Affiliation Strings to ROR IDs"},{"type":"url","value":"https://www.youtube.com/watch?v=MzfeUJwtDBg","name":"Video: Smart matching enabled by the ROR API for the OA Switchboard"},{"type":"url","value":"https://github.com/ror-community/ror-utilities","name":"ror-utilities matching and mapping scripts"}]},"algolia":{"recordCount":11,"publishPending":false,"translationFailure":false,"updatedAt":"2024-12-13T22:19:39.106Z"},"title":"Match organization names to ROR IDs","icon":"","updates":["6270618145a84b005640b92d"],"type":"basic","slug":"matching","excerpt":"","body":"If you have organization names or full affiliation strings stored in your system as text, there are several approaches to matching those text strings to ROR IDs. \n\nThe approaches given below are for cases when you have a list, a spreadsheet, or a database with organization information as text strings, often with \"extra\" text such as a department or address as well as the organization's name, but no corresponding organization IDs. \n\nExamples of organization names and affiliation information as text strings and the corresponding ROR ID: \n\n- University of Haifa > <https://ror.org/02f009v59> \n- University of ManchesterGreater Manchester Mental Health NHS Foundation TrustNational Institute for Health Research (NIHR) Greater Manchester Patient Safety Translational Research Centre > <https://ror.org/05sb89p83> \n- Atmospheric Sciences and Global Change Division, Pacific Northwest National Laboratory, Richland, WA, USA > <https://ror.org/05h992307> \n\n> 📘 Mapping names and IDs to ROR\n> \n> If you have organization names along with another global organization ID (Crossref Funder ID, GRID, ISNI, or Wikidata), you may find quicker, more accurate results by mapping those other IDs to ROR. See [Map other organization ID types to ROR](doc:mapping). \n> \n> If you need to match ROR IDs to user input in a web application, see [Create ROR-powered typeaheads in forms](doc:forms).\n\n## Match organization names to ROR IDs using the ROR API\n\n### Query vs affiliation parameter\n\nThe [ROR API](doc:api-about) offers 2 ways to search ROR records, which work slightly differently and return different results:\n\n- **[Affiliation parameter](#affiliation-parameter-approach)** `/organizations?affiliation=`: Searches `name`, `aliases`, and `labels` fields using different search algorithms and returns the best match(es) based on matching score. Includes matching score and true/false indicator of whether the score is high enough to be considered a reliable match. Produces about 85% correct matches in our tests; individual implementations may see better or worse results. \n\n- **[Query parameter](#query-parameter-approach)** `/organizations?query=`: Searches `name`, `aliases`, `labels`, `acronyms`, and `external_ids` fields in ROR records and returns all matching records. Does NOT include a matching score or true/false indicator of whether the score is high enough to be considered a reliable match.\n\nFor cases where you have relatively unique organization names or full affiliation strings, use the [affiliation parameter approach](#affiliation-parameter-approach). Works for both English and non-English name variations. Examples:\n\n- Incorporated Research Institutions for Seismology (IRIS)\n- Universitätsbibliothek der Ludwig-Maximilians-Universität München\n- Department of Civil and Industrial Engineering, University of Pisa, Largo Lucio Lazzarino 2, Pisa 56126, Italy\n\nFor cases where you have very common organization names, use the [query parameter approach](#query-parameter-approach) to look for keywords from the organization's name or the exact name of the organization surrounded by double quotation marks, and consider using filters for organization type and country. Examples:\n\n- Ministry of Health\n- National Research Council\n- York University\n\n> 📘 Retrieving active and inactive organizations\n> \n> By default, both the affiliation parameter and the query parameter will return only records with an active [status](doc:data-structure#status): `status: \"active\"`. Consider whether you also want to retrieve records with an inactive status; inactive records generally represent organizations that no longer operate. See [API filtering](doc:api-filtering) for details. \n> \n> Be aware too that inactive organizations may be succeeded by a new organization under a different name with a different ROR ID. If you do retrieve inactive organizations, check the `relationships` field of an inactive record to see if it has a [Successor organization](doc:data-structure#relationships).\n\n### Affiliation parameter approach\n\nSearches `name`, `aliases` and `labels` 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>`. For the full list of fields returned, see [Fields and sub-fields](doc:fields).\n\n```curl\ncurl 'https://api.ror.org/v1/organizations?affiliation=university+of+wisconsin+madison' | json_pp\n```\n\nIf there's a high-confidence match, it will appear as the first result, with `\"chosen\": true`. Other results and their matching score will also be returned, but if you're automating this process using a script, we recommend using results with `\"chosen\": true` rather than relying on the score. Results are paginated: see [API paging](doc:api-paging) for details.\n\n```json\n{\n \"items\" : [\n {\n \"chosen\" : true,\n \"matching_type\" : \"EXACT\",\n \"organization\" : {\n \"acronyms\" : [\n \"UW\"\n ],\n \"addresses\" : [\n {\n \"city\" : \"Madison\",\n \"country_geonames_id\" : null,\n \"geonames_city\" : {\n \"city\" : \"Madison\",\n \"geonames_admin1\" : {\n \"ascii_name\" : null,\n \"code\" : \"US.WI\",\n \"id\" : null,\n \"name\" : \"Wisconsin\"\n },\n \"geonames_admin2\" : {\n \"ascii_name\" : null,\n \"code\" : null,\n \"id\" : null,\n \"name\" : null\n },\n \"id\" : 5261457,\n \"license\" : {\n \"attribution\" : \"Data from geonames.org under a CC-BY 3.0 license\",\n \"license\" : \"http://creativecommons.org/licenses/by/3.0/\"\n },\n \"nuts_level1\" : {\n \"code\" : null,\n \"name\" : null\n },\n \"nuts_level2\" : {\n \"code\" : null,\n \"name\" : null\n },\n \"nuts_level3\" : {\n \"code\" : null,\n \"name\" : null\n }\n },\n \"lat\" : 43.07305,\n \"line\" : null,\n \"lng\" : -89.40123,\n \"postcode\" : null,\n \"primary\" : false,\n \"state\" : null,\n \"state_code\" : null\n }\n ],\n \"aliases\" : [\n \"UW–Madison\"\n ],\n \"country\" : {\n \"country_code\" : \"US\",\n \"country_name\" : \"United States\"\n },\n \"email_address\" : null,\n \"established\" : 1848,\n \"external_ids\" : {\n \"FundRef\" : {\n \"all\" : [\n \"100007015\",\n \"100008959\",\n \"100005996\",\n \"100007870\",\n \"100008301\",\n \"100008028\",\n \"100008237\",\n \"100008161\",\n \"100010495\",\n \"100009627\",\n \"100010284\",\n \"100005911\",\n \"100007925\",\n \"100005902\",\n \"100012787\"\n ],\n \"preferred\" : \"100007015\"\n },\n \"GRID\" : {\n \"all\" : \"grid.14003.36\",\n \"preferred\" : \"grid.14003.36\"\n },\n \"ISNI\" : {\n \"all\" : [\n \"0000 0001 2167 3675\"\n ],\n \"preferred\" : null\n },\n \"Wikidata\" : {\n \"all\" : [\n \"Q838330\",\n \"Q33122195\",\n \"Q7662222\"\n ],\n \"preferred\" : \"Q838330\"\n }\n },\n \"id\" : \"https://ror.org/01y2jtd41\",\n \"ip_addresses\" : [],\n \"labels\" : [\n {\n \"iso639\" : \"es\",\n \"label\" : \"Universidad de Wisconsin-Madison\"\n },\n {\n \"iso639\" : \"fr\",\n \"label\" : \"Université du Wisconsin à Madison\"\n }\n ],\n \"links\" : [\n \"http://www.wisc.edu/\"\n ],\n \"name\" : \"University of Wisconsin–Madison\",\n \"relationships\" : [\n {\n \"id\" : \"https://ror.org/05cb4rb43\",\n \"label\" : \"Morgridge Institute for Research\",\n \"type\" : \"Child\"\n },\n {\n \"id\" : \"https://ror.org/04gq8q482\",\n \"label\" : \"North Temperate Lakes Long Term Ecological Research\",\n \"type\" : \"Child\"\n },\n {\n \"id\" : \"https://ror.org/03ydkyb10\",\n \"label\" : \"University of Wisconsin System\",\n \"type\" : \"Parent\"\n },\n {\n \"id\" : \"https://ror.org/03b8vas82\",\n \"label\" : \"National Atmospheric Deposition Program\",\n \"type\" : \"Related\"\n },\n {\n \"id\" : \"https://ror.org/04r3s7465\",\n \"label\" : \"McMurdo Dry Valleys Long Term Ecological Research\",\n \"type\" : \"Related\"\n },\n {\n \"id\" : \"https://ror.org/02kj3rm24\",\n \"label\" : \"Wisconsin Geological and Natural History Survey\",\n \"type\" : \"Child\"\n }\n ],\n \"status\" : \"active\",\n \"types\" : [\n \"Education\",\n \"Funder\"\n ],\n \"wikipedia_url\" : \"http://en.wikipedia.org/wiki/University_of_Wisconsin%E2%80%93Madison\"\n },\n \"score\" : 1,\n \"substring\" : \"university of wisconsin madison\"\n },\n {\n \"chosen\" : false,\n \"matching_type\" : \"EXACT\",\n \"organization\" : {\n \"acronyms\" : [\n \"UWHC\"\n ],\n \"addresses\" : [\n {\n \"city\" : \"Madison\",\n \"country_geonames_id\" : null,\n \"geonames_city\" : {\n \"city\" : \"Madison\",\n \"geonames_admin1\" : {\n \"ascii_name\" : null,\n \"code\" : \"US.WI\",\n \"id\" : null,\n \"name\" : \"Wisconsin\"\n },\n \"geonames_admin2\" : {\n \"ascii_name\" : null,\n \"code\" : null,\n \"id\" : null,\n \"name\" : null\n },\n \"id\" : 5261457,\n \"license\" : {\n \"attribution\" : \"Data from geonames.org under a CC-BY 3.0 license\",\n \"license\" : \"http://creativecommons.org/licenses/by/3.0/\"\n },\n \"nuts_level1\" : {\n \"code\" : null,\n \"name\" : null\n },\n \"nuts_level2\" : {\n \"code\" : null,\n \"name\" : null\n },\n \"nuts_level3\" : {\n \"code\" : null,\n \"name\" : null\n }\n },\n \"lat\" : 43.07305,\n \"line\" : null,\n \"lng\" : -89.40123,\n \"postcode\" : null,\n \"primary\" : false,\n \"state\" : null,\n \"state_code\" : null\n }\n ],\n \"aliases\" : [\n \"UW Hospital and Clinics\",\n \"University of Wisconsin Health University Hospital\",\n \"University of Wisconsin Hospital and Clinics\",\n \"University of Wisconsin-Madison Hospital\",\n \"Wisconsin General Hospital\"\n ],\n \"country\" : {\n \"country_code\" : \"US\",\n \"country_name\" : \"United States\"\n },\n \"email_address\" : null,\n \"established\" : 1924,\n \"external_ids\" : {\n \"GRID\" : {\n \"all\" : \"grid.412647.2\",\n \"preferred\" : \"grid.412647.2\"\n },\n \"ISNI\" : {\n \"all\" : [\n \"0000 0000 9209 0955\"\n ],\n \"preferred\" : null\n },\n \"Wikidata\" : {\n \"all\" : [\n \"Q7896631\"\n ],\n \"preferred\" : null\n }\n },\n \"id\" : \"https://ror.org/02mqqhj42\",\n \"ip_addresses\" : [],\n \"labels\" : [],\n \"links\" : [\n \"https://www.uwhealth.org/locations/university-hospital-170\"\n ],\n \"name\" : \"UW Health University Hospital\",\n \"relationships\" : [\n {\n \"id\" : \"https://ror.org/01e4byj08\",\n \"label\" : \"University of Wisconsin Carbone Cancer Center\",\n \"type\" : \"Child\"\n },\n {\n \"id\" : \"https://ror.org/03e3qgk42\",\n \"label\" : \"University of Wisconsin Health\",\n \"type\" : \"Parent\"\n }\n ],\n \"status\" : \"active\",\n \"types\" : [\n \"Healthcare\"\n ],\n \"wikipedia_url\" : \"https://en.wikipedia.org/wiki/University_of_Wisconsin_Hospital_and_Clinics\"\n },\n \"score\" : 0.87,\n \"substring\" : \"university of wisconsin madison\"\n },\n {\n \"chosen\" : false,\n \"matching_type\" : \"EXACT\",\n \"organization\" : {\n \"acronyms\" : [\n \"UWCCC\"\n ],\n \"addresses\" : [\n {\n \"city\" : \"Madison\",\n \"country_geonames_id\" : null,\n \"geonames_city\" : {\n \"city\" : \"Madison\",\n \"geonames_admin1\" : {\n \"ascii_name\" : null,\n \"code\" : \"US.WI\",\n \"id\" : null,\n \"name\" : \"Wisconsin\"\n },\n \"geonames_admin2\" : {\n \"ascii_name\" : null,\n \"code\" : null,\n \"id\" : null,\n \"name\" : null\n },\n \"id\" : 5261457,\n \"license\" : {\n \"attribution\" : \"Data from geonames.org under a CC-BY 3.0 license\",\n \"license\" : \"http://creativecommons.org/licenses/by/3.0/\"\n },\n \"nuts_level1\" : {\n \"code\" : null,\n \"name\" : null\n },\n \"nuts_level2\" : {\n \"code\" : null,\n \"name\" : null\n },\n \"nuts_level3\" : {\n \"code\" : null,\n \"name\" : null\n }\n },\n \"lat\" : 43.07305,\n \"line\" : null,\n \"lng\" : -89.40123,\n \"postcode\" : null,\n \"primary\" : false,\n \"state\" : null,\n \"state_code\" : null\n }\n ],\n \"aliases\" : [\n \"Carbone Cancer Center\",\n \"UW Carbone\",\n \"UW Carbone Cancer Center\",\n \"UW Carbone Comprehensive Cancer Center\",\n \"UWCCC Madison\",\n \"University of Wisconsin Cancer Center\",\n \"University of Wisconsin Carbone Comprehensive Cancer Center\",\n \"University of Wisconsin Comprehensive Cancer Center\",\n \"University of Wisconsin-Madison Carbone Cancer Center\"\n ],\n \"country\" : {\n \"country_code\" : \"US\",\n \"country_name\" : \"United States\"\n },\n \"email_address\" : null,\n \"established\" : 1940,\n \"external_ids\" : {\n \"FundRef\" : {\n \"all\" : [\n \"100007923\"\n ],\n \"preferred\" : \"100007923\"\n },\n \"GRID\" : {\n \"all\" : \"grid.412639.b\",\n \"preferred\" : \"grid.412639.b\"\n },\n \"ISNI\" : {\n \"all\" : [\n \"0000 0001 2191 1477\"\n ],\n \"preferred\" : null\n },\n \"Wikidata\" : {\n \"all\" : [\n \"Q7876154\"\n ],\n \"preferred\" : null\n }\n },\n \"id\" : \"https://ror.org/01e4byj08\",\n \"ip_addresses\" : [],\n \"labels\" : [],\n \"links\" : [\n \"https://cancer.wisc.edu\"\n ],\n \"name\" : \"University of Wisconsin Carbone Cancer Center\",\n \"relationships\" : [\n {\n \"id\" : \"https://ror.org/02mqqhj42\",\n \"label\" : \"UW Health University Hospital\",\n \"type\" : \"Parent\"\n }\n ],\n \"status\" : \"active\",\n \"types\" : [\n \"Funder\",\n \"Healthcare\"\n ],\n \"wikipedia_url\" : \"https://en.wikipedia.org/wiki/University_of_Wisconsin_Carbone_Cancer_Center\"\n },\n \"score\" : 0.76,\n \"substring\" : \"university of wisconsin madison\"\n }\n ],\n \"number_of_results\" : 3\n}\n```\n\n> 🚧 Don't automatically select the first \"unchosen\" result of an ?affiliation query with no `chosen: true` result\n> \n> When no result has `\"chosen\": true`, the first result is not necessarily the best match for a given affiliation string. In that case, several results may have the exact same score and/or there may be no match with a high score. Because the affiliation service breaks a given affiliation string into multiple substrings and performs searches of each substring on its own as well as in combination with other substrings, a high scoring match that is not selected as chosen may be a match to only a small portion of the entire affiliation string. In these cases, it is best to respect the absence of `\"chosen: true\"` and leave the string unmatched or add a layer of human or machine assignment, at your discretion.\n\n#### Additional request examples:\n\nIncorporated Research Institutions for Seismology (IRIS)\n\n```curl\ncurl 'https://api.ror.org/v1/organizations?affiliation=Incorporated%20Research%20Institutions%20for%20Seismology%20(IRIS)' | json_pp\n```\n\nUniversitätsbibliothek der Ludwig-Maximilians-Universität München\n\n```curl\ncurl 'https://api.ror.org/v1/organizations?affiliation=Universit%C3%A4tsbibliothek%20der%20Ludwig-Maximilians-Universit%C3%A4t%20M%C3%BCnchen' | json_pp\n```\n\nDepartment of Civil and Industrial Engineering, University of Pisa, Largo Lucio Lazzarino 2, Pisa 56126, Italy\n\n```curl\ncurl 'https://api.ror.org/v1/organizations?affiliation=Department%20of%20Civil%20and%20Industrial%20Engineering%2C%20University%20of%20Pisa%2C%20Largo%20Lucio%20Lazzarino%202%2C%20Pisa%2056126%2C%20Italy' | json_pp\n```\n\n### Query parameter approach\n\nSearch all indexed fields in ROR records using the format `https://api.ror.org/organizations?query=<search term>&filter=<filters>`. We strongly recommend using [organization type and country filters](doc:filtering). For more information, see the [REST API guide](doc:rest-api).\n\n```curl\ncurl 'https://api.ror.org/v1/organizations?query=%22Ministry+of+Health%22&filter=types:Government,country.country_code:NZ' | json_pp\n```\n\nThe response is a JSON object containing full records for the first 20 search results. Results are paginated: see [API paging](doc:api-paging) for details. Matching scores are not included, but closest matches are at the beginning of the list. \n\n> 📘 Query parameter searches may return many results, so some amount of human intervention may be needed to determine the matching ROR ID (if there is one).\n\n```curl\n{\n \"items\" : [\n {\n \"acronyms\" : [],\n \"addresses\" : [\n {\n \"city\" : \"Wellington\",\n \"country_geonames_id\" : null,\n \"geonames_city\" : {\n \"city\" : \"Wellington\",\n \"geonames_admin1\" : {\n \"ascii_name\" : null,\n \"code\" : \"NZ.WGN\",\n \"id\" : null,\n \"name\" : \"Wellington Region\"\n },\n \"geonames_admin2\" : {\n \"ascii_name\" : null,\n \"code\" : null,\n \"id\" : null,\n \"name\" : null\n },\n \"id\" : 2179537,\n \"license\" : {\n \"attribution\" : \"Data from geonames.org under a CC-BY 3.0 license\",\n \"license\" : \"http://creativecommons.org/licenses/by/3.0/\"\n },\n \"nuts_level1\" : {\n \"code\" : null,\n \"name\" : null\n },\n \"nuts_level2\" : {\n \"code\" : null,\n \"name\" : null\n },\n \"nuts_level3\" : {\n \"code\" : null,\n \"name\" : null\n }\n },\n \"lat\" : -41.28664,\n \"line\" : null,\n \"lng\" : 174.77557,\n \"postcode\" : null,\n \"primary\" : false,\n \"state\" : null,\n \"state_code\" : null\n }\n ],\n \"aliases\" : [\n \"Manatū Hauora\"\n ],\n \"country\" : {\n \"country_code\" : \"NZ\",\n \"country_name\" : \"New Zealand\"\n },\n \"email_address\" : null,\n \"established\" : 1903,\n \"external_ids\" : {\n \"FundRef\" : {\n \"all\" : [\n \"501100001504\"\n ],\n \"preferred\" : null\n },\n \"GRID\" : {\n \"all\" : \"grid.415708.f\",\n \"preferred\" : \"grid.415708.f\"\n },\n \"ISNI\" : {\n \"all\" : [\n \"0000 0004 0483 5988\"\n ],\n \"preferred\" : null\n },\n \"Wikidata\" : {\n \"all\" : [\n \"Q16933991\"\n ],\n \"preferred\" : null\n }\n },\n \"id\" : \"https://ror.org/00vjb5165\",\n \"ip_addresses\" : [],\n \"labels\" : [],\n \"links\" : [\n \"http://www.health.govt.nz/\"\n ],\n \"name\" : \"Ministry of Health\",\n \"relationships\" : [],\n \"status\" : \"active\",\n \"types\" : [\n \"Government\",\n \"Funder\"\n ],\n \"wikipedia_url\" : \"https://en.wikipedia.org/wiki/Ministry_of_Health_(New_Zealand)\"\n }\n ],\n \"meta\" : {\n \"countries\" : [\n {\n \"count\" : 1,\n \"id\" : \"nz\",\n \"title\" : \"New Zealand\"\n }\n ],\n \"statuses\" : [\n {\n \"count\" : 1,\n \"id\" : \"active\",\n \"title\" : \"active\"\n }\n ],\n \"types\" : [\n {\n \"count\" : 1,\n \"id\" : \"funder\",\n \"title\" : \"Funder\"\n },\n {\n \"count\" : 1,\n \"id\" : \"government\",\n \"title\" : \"Government\"\n }\n ]\n },\n \"number_of_results\" : 1,\n \"time_taken\" : 6\n}\n```\n\n## Matching a list of organization names to ROR IDs using a script\n\nYou can write your own script to match a list of organization names to ROR IDs via the ROR API, though some manual intervention will likely be needed to make sure that matches are correct. If you are writing a script, remember the following:\n\n- Try the [affiliation parameter approach](#affiliation-parameter-approach) first instead of the [query parameter approach](#query-parameter-approach).\n- Look for \"chosen\" results where `\"chosen\": true`. \n- If no results are found, try alternate names/acronyms (if you have them) or try the query parameter approach. \n- API results are paginated: see [API paging](#api-paging) for details.\n- By default, API requests will return only records with an active [status](doc:data-structure#status): `status: \"active\"`. Consider whether you want to retrieve records with an inactive status as well; inactive records generally represent organizations that no longer operate. See [API filtering](doc:api-filtering) for details. \n\nSee, use, and clone examples of Python scripts that match organization names to ROR IDs in the [ror-utilities Github repository](https://github.com/ror-community/ror-utilities).\n\n## Match organization names to ROR IDs using the data dump\n\nInstead of using the ROR API, you can use your own scripts or processing tools on the [ROR data dump](doc:data-dump) to match organization names to ROR IDs. Advantages of this approach include:\n\n- Fine-grained control over matching criteria\n- Faster processing in cases where you have many IDs to map\n- No chance of error responses due to network interruptions or API outages\n\n## Match organization names to ROR using OpenRefine\n\nThe **ROR OpenRefine Reconciler** is a fairly labor-intensive way of matching organization names to ROR IDs, but it works well for those who have a relatively small list of organization names, those who want to have a high degree of control and oversight over the matching process, and those who do not want to write code. \n\n[OpenRefine](https://openrefine.org) (formerly Google Refine) is a free, open source desktop tool for cleaning up messy data stored in common formats like CSV, JSON, XML, XLS. You can even use it to connect to SQL-based databases and Google Sheets. \n\nSee [ROR OpenRefine Reconciler](doc:openrefine-reconciler) for written usage instructions, screenshots, and a tutorial video. \n\n## Match organization names to ROR IDs using third-party tools\n\nSeveral projects and researchers have developed scripts and/or machine learning and artificial intelligence tools that match textual organization information to ROR IDs. Several of these tools are fast and can work with large amounts of data with accuracy rates before human intervention ranging from about 85% to 95%. These tools are not officially supported by ROR, but we list them here in case you find them useful. \n\n- [OpenAlex Institution Parsing](https://github.com/ourresearch/openalex-institution-parsing) by OurResearch\n\n- [S2AFF - Semantic Scholar Affiliations Linker](https://github.com/allenai/S2AFF/) by the Allen AI Institute\n\n- [RORRetriever](https://github.com/Metadata-Game-Changers/RORRetriever) by Metadata Game Changers\n\n- [EMBL-EBI ROR Predictor prototype](https://gitlab.ebi.ac.uk/literature-services/public-projects/ROR-proto-EMBL) by EMBL-EBI for [Project FREYA](https://www.project-freya.eu/Plone/en)\n\n- [dataESR affiliation matcher](https://github.com/dataesr/affiliation-matcher) developed by Anne L'Hôte and Eric Jeangirard for the French Ministry of Higher Education\n\n- [OpenAlex ROR Predictor (gpu-based)](https://github.com/adambuttrick/openalex-ror-predictor) by ROR Curation Lead Adam Buttrick\n\n- [fastText ROR Predictor (cpu-based)](https://github.com/adambuttrick/ror-predictor-fasttext) by ROR Curation Lead Adam Buttrick\n\n- [lr_predictor](https://github.com/adambuttrick/lr_matches) by ROR Curation Lead Adam Buttrick\n\n- [ROR experimental affiliation matching](https://github.com/ror-community/affiliation-matching-experimental) - A collection of data and code for training models and experimenting with automatically matching affiliation strings to ROR IDs. Not production code, and not officially supported by ROR. \n\n## Testing and training data\n\nROR is currently experimenting with strategies for automatically matching affiliation strings to ROR IDs, and we have collected sets of data from Springer Nature, the American Physical Society, Crossref, and OpenAlex for testing and training matching strategies that are openly available at <https://github.com/ror-community/affiliation-matching-experimental/tree/main/test_data>. These datasets include affiliation text strings from production systems that have been matched to ROR IDs with varying levels of human review.","order":1,"isReference":false,"deprecated":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"reusableContent":[],"previousSlug":"match-organization-names-to-ror-ids","slugUpdatedAt":"2024-03-09T19:25:32.419Z","revision":130,"_id":"60d3e4c27dccd0004443bc84","pendingAlgoliaPublish":false,"createdAt":"2021-06-24T01:49:54.894Z","updatedAt":"2024-12-13T22:19:39.112Z","user":"62a72c1fbac94d016a0d28fe","category":{"title":"Collecting ROR IDs","slug":"mapping-and-matching","order":7,"reference":false,"_id":"64426d364b8f4c00604bb504","project":"6058e47681775f002de04832","version":"6058e47681775f002de04837","createdAt":"2023-04-21T11:02:14.913Z","__v":0,"type":"guide","id":"64426d364b8f4c00604bb504"},"project":"6058e47681775f002de04832","version":{"version":"1","version_clean":"1.0.0","codename":"","is_stable":true,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["6058e47681775f002de04839","6058e47681775f002de04839","6058e47681775f002de0483f","60d3d003d5ef44000f12c6c5","60de178b3321e40069edd8ac","63581e7c2875a60bd7564745","6376be56127d99000315eda9","64426d364b8f4c00604bb504","653c1e6f1cd9f1004b55cc72","65ec6c03aff86d0072a566d7"],"pdfStatus":"","_id":"6058e47681775f002de04837","project":"6058e47681775f002de04832","releaseDate":"2021-03-22T18:39:50.198Z","createdAt":"2021-03-22T18:39:50.198Z","__v":2,"updatedAt":"2024-04-11T20:46:41.458Z"},"__v":8,"parentDoc":null,"lastUpdatedHash":"014074ceda203a2e222f291378ca45e3c47e30a6","mdxAltBody":"","isApi":false,"tutorials":[],"id":"60d3e4c27dccd0004443bc84"},"hideTOC":false,"meta":{"_id":"60d3e4c27dccd0004443bc84","description":"This document provides guidance on matching organization names to ROR IDs using the ROR API, including different approaches like the affiliation parameter and query parameter methods. It also mentions using scripts, the ROR data dump, OpenRefine, and third-party tools for this purpose.","hidden":false,"image":[],"keywords":"","metaTitle":"Match organization names to ROR IDs","parent":null,"robots":"index","slug":"matching","title":"Match organization names to ROR IDs","type":"docs"},"slugUrl":"/docs/matching","config":{"algoliaIndex":"readme_search_v2","amplitude":{"apiKey":"dc8065a65ef83d6ad23e37aaf014fc84","enabled":true},"asset_url":"https://cdn.readme.io","domain":"readme.io","domainFull":"https://dash.readme.com","encryptedLocalStorageKey":"ekfls-2024-05","fullstory":{"enabled":true,"orgId":"FSV9A"},"metrics":{"billingCronEnabled":"true","dashUrl":"https://m.readme.io","defaultUrl":"https://m.readme.io","exportMaxRetries":12,"wsUrl":"wss://m.readme.io"},"proxyUrl":"https://try.readme.io","readmeRecaptchaSiteKey":"6LesVBYpAAAAAESOCHOyo2kF9SZXPVb54Nwf3i2x","releaseVersion":"5.281.0","sentry":{"dsn":"https://3bbe57a973254129bcb93e47dc0cc46f@o343074.ingest.sentry.io/2052166","enabled":true,"tracesSampleRate":0},"shMigration":{"promoVideo":"","forceWaitlist":false},"sslBaseDomain":"readmessl.com","sslGenerationService":"ssl.readmessl.com","stripePk":"pk_live_5103PML2qXbDukVh7GDAkQoR4NSuLqy8idd5xtdm9407XdPR6o3bo663C1ruEGhXJjpnb2YCpj8EU1UvQYanuCjtr00t1DRCf2a","superHub":{"newProjectsEnabled":true},"wootric":{"accountToken":"NPS-122b75a4","enabled":true}},"context":{"labs":{},"user":{},"terms":[{"_id":"6058e47681775f002de04833","term":"parliament","definition":"Owls are generally solitary, but when seen together the group is called a 'parliament'!"}],"variables":{"user":{},"defaults":[]},"project":{"_id":"6058e47681775f002de04832","appearance":{"rdmd":{"callouts":{"useIconFont":false},"theme":{"background":"","border":"","markdownEdge":"","markdownFont":"","markdownFontSize":"","markdownLineHeight":"","markdownRadius":"","markdownText":"","markdownTitle":"","markdownTitleFont":"","mdCodeBackground":"","mdCodeFont":"","mdCodeRadius":"","mdCodeTabs":"","mdCodeText":"","tableEdges":"","tableHead":"","tableHeadText":"","tableRow":"","tableStripe":"","tableText":"","text":"","title":""}},"main_body":{"type":"links"},"colors":{"highlight":"","main":"#44A28F","main_alt":"","header_text":"","body_highlight":"","custom_login_link_color":""},"typography":{"headline":"Open+Sans:400:sans-serif","body":"Open+Sans:400:sans-serif","typekit":false,"tk_key":"","tk_headline":"","tk_body":""},"header":{"style":"solid","img":[],"img_size":"auto","img_pos":"tl"},"body":{"style":"none"},"global_landing_page":{"html":"","redirect":""},"referenceLayout":"row","link_logo_to_url":true,"theme":"solid","overlay":"triangles","landing":true,"sticky":false,"hide_logo":false,"childrenAsPills":false,"subheaderStyle":"links","splitReferenceDocs":false,"logo":["https://files.readme.io/4680beec6938bde00138451225326037ace6f6e8011c88b92e902c051dfb922e-small-ror-logo-2600px.png","4680beec6938bde00138451225326037ace6f6e8011c88b92e902c051dfb922e-small-ror-logo-2600px.png",136,80,"#242c24","https://files.readme.io/044ba45b93ac5dedcb918fd8280e53ec0243dd1b04b9edaed5ba61d09283f7b7-ror-logo-2600px.png","6762cc61aa21d600184034d9"],"logo_white":["https://files.readme.io/dacd566-white-logo.png","dacd566-white-logo.png",125,80,"#ffffff","65ef46717fce1c0036177477"],"logo_white_use":false,"favicon":["https://files.readme.io/a931430-small-ror-icon-profile_2.png","ror-icon-profile (2).png",32,32,"#d8e0de","https://files.readme.io/a2115cf-ror-icon-profile_2.png"],"stylesheet":"","stylesheet_hub2":"","javascript":"","javascript_hub2":"","html_promo":"","html_body":"","html_footer":"","html_head":"","html_footer_meta":"","html_hidelinks":false,"showVersion":true,"hideTableOfContents":false,"nextStepsLabel":"Other resources you might find helpful","promos":[{"extras":{"type":"buttons","buttonPrimary":"get-started","buttonSecondary":"none"},"title":"ROR Documentation","text":"Comprehensive technical documentation for the Research Organization Registry (ROR), including ROR's metadata schema and REST API, plus implementation guides. Let's ROR!","_id":"6058e47681775f002de04834"}],"showMetricsInReference":true,"referenceSimpleMode":true,"stylesheet_hub3":"","loginLogo":[],"colorScheme":"light","logo_large":true,"changelog":{"layoutExpanded":false,"showAuthor":true,"showExactDate":false},"allowApiExplorerJsonEditor":false},"custom_domain":"","childrenProjects":[],"derivedPlan":"opensource","description":"Technical documentation for ROR, the Research Organization Registry, a global, community-led registry of open persistent identifiers for research organizations.","error404":"","experiments":[],"first_page":"landing","flags":{"allow_hub2":false,"enterprise":false,"alwaysShowDocPublishStatus":false,"hub2":true,"migrationRun":false,"migrationSwaggerRun":false,"oauth":false,"swagger":false,"correctnewlines":false,"rdmdCompatibilityMode":false,"speedyRender":false,"allowXFrame":false,"newEditor":true,"oldMarkdown":false,"useReactApp":true,"newMarkdownBetaProgram":true,"referenceRedesign":false,"disableAnonForum":false,"directGoogleToStableVersion":false,"translation":false,"staging":false,"newSearch":true,"allowApiExplorerJsonEditor":false,"newHeader":false,"auth0Oauth":false,"graphql":false,"singleProjectEnterprise":false,"dashReact":false,"allowReferenceUpgrade":false,"metricsV2":true,"enableRealtimeExperiences":false,"newEditorDash":true,"allowDarkMode":false,"forceDarkMode":false,"reviewWorkflow":true,"star":false,"useReactGLP":false,"disablePasswordlessLogin":false,"myDevelopers":false,"superHub":false,"allowReusableOTPs":false,"developerDashboard":false,"owlbotAi":false,"apiV2":false,"dashQuickstart":false,"git":{"read":false,"write":false},"superHubBeta":false,"customBlocks":false,"devDashHub":false,"disableAutoTranslate":false,"disableSAMLScoping":false,"allowUnsafeCustomHtmlSuggestionsFromNonAdmins":false,"apiAccessRevoked":false,"billingRedesignEnabled":true,"disableSignups":false,"passwordlessLogin":"default","developerPortal":false,"mdx":false,"superHubDevelopment":false,"annualBillingEnabled":true,"enableOidc":false,"changelogRssAlwaysPublic":false,"customComponents":false,"developerViewUsersData":false,"disableDiscussionSpamRecaptchaBypass":false,"bidiSync":false,"apiDesigner":false,"hideEnforceSSO":false,"superHubMigrationSelfServeFlow":false,"localLLM":false,"superHubManageVersions":false,"gitSidebar":false},"fullBaseUrl":"https://ror.readme.io/","git":{"migration":{"createRepository":{},"transformation":{},"migratingPages":{},"enableSuperhub":{}},"sync":{"connectedRepository":{"organization":{},"privacy":{}},"installationRequest":{},"github":[]}},"glossaryTerms":[{"_id":"6058e47681775f002de04833","term":"parliament","definition":"Owls are generally solitary, but when seen together the group is called a 'parliament'!"}],"graphqlSchema":"","gracePeriod":{"enabled":false,"endsAt":null},"shouldGateDash":false,"healthCheck":{"provider":"","settings":{}},"intercom_secure_emailonly":false,"intercom":"","is_active":true,"integrations":{"login":{}},"internal":"","jwtExpirationTime":0,"landing_bottom":[{"type":"text","alignment":"left","title":"Announcing ROR schema 2.1!","text":"We've just released a new non-breaking update to the ROR schema that adds location information for continents and country subdivisions to ROR records. Read more about Schema 2.1 in the changelog at https://ror.readme.io/changelog/2024-12-12-schema-v2-1."},{"type":"docs","alignment":"left","pageType":"Documentation"}],"mdxMigrationStatus":"rdmd","metrics":{"monthlyLimit":0,"thumbsEnabled":true,"planLimit":1000000,"realtime":{"dashEnabled":false,"hubEnabled":false},"monthlyPurchaseLimit":0,"meteredBilling":{}},"modules":{"landing":true,"docs":true,"examples":false,"reference":false,"changelog":true,"discuss":false,"suggested_edits":true,"logs":false,"custompages":false,"tutorials":false,"graphql":false},"name":"ROR","nav_names":{"docs":"","reference":"","changelog":"","discuss":"","tutorials":"","recipes":""},"oauth_url":"","onboardingCompleted":{"documentation":true,"appearance":true,"jwt":false,"api":true,"logs":false,"domain":false,"metricsSDK":false},"owlbot":{"enabled":false,"isPaying":false,"customization":{"answerLength":"long","customTone":"","defaultAnswer":"","forbiddenWords":"","tone":"neutral"},"copilot":{"enabled":false,"hasBeenUsed":false,"installedCustomPage":""}},"owner":{"id":null,"email":null,"name":null},"plan":"freelaunch","planOverride":"opensource","planSchedule":{"stripeScheduleId":null,"changeDate":null,"nextPlan":null},"planStatus":"","planTrial":"opensource","readmeScore":{"components":{"newDesign":{"enabled":true,"points":25},"reference":{"enabled":false,"points":50},"tryItNow":{"enabled":true,"points":35},"syncingOAS":{"enabled":false,"points":10},"customLogin":{"enabled":false,"points":25},"metrics":{"enabled":false,"points":40},"recipes":{"enabled":false,"points":15},"pageVoting":{"enabled":false,"points":1},"suggestedEdits":{"enabled":false,"points":10},"support":{"enabled":false,"points":5},"htmlLanding":{"enabled":false,"points":5},"guides":{"enabled":true,"points":10},"changelog":{"enabled":false,"points":5},"glossary":{"enabled":false,"points":1},"variables":{"enabled":false,"points":1},"integrations":{"enabled":false,"points":2}},"percentScore":25,"totalScore":70},"reCaptchaSiteKey":"","reference":{"alwaysUseDefaults":true,"defaultExpandResponseExample":false,"defaultExpandResponseSchema":false,"enableOAuthFlows":false},"seo":{"overwrite_title_tag":true},"stable":{"_id":"6058e47681775f002de04837","version":"1","version_clean":"1.0.0","codename":"","is_stable":true,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["6058e47681775f002de04839","6058e47681775f002de04839","6058e47681775f002de0483f","60d3d003d5ef44000f12c6c5","60de178b3321e40069edd8ac","63581e7c2875a60bd7564745","6376be56127d99000315eda9","64426d364b8f4c00604bb504","653c1e6f1cd9f1004b55cc72","65ec6c03aff86d0072a566d7"],"project":"6058e47681775f002de04832","releaseDate":"2021-03-22T18:39:50.198Z","createdAt":"2021-03-22T18:39:50.198Z","__v":2,"updatedAt":"2024-04-11T20:46:41.458Z"},"subdomain":"ror","subpath":"","superHubWaitlist":false,"topnav":{"left":[{"type":"url","text":"Report a bug or request a feature","url":"https://github.com/ror-community/ror-roadmap/issues/new/choose"},{"type":"url","text":"Contact support","url":"mailto:support@ror.org"}],"right":[{"type":"user","text":"User","url":"/login?redirect_uri=/docs/matching"}],"edited":true,"bottom":[]},"trial":{"trialDeadlineEnabled":true,"trialEndsAt":"2021-04-05T18:39:50.145Z"},"translate":{"provider":"transifex","show_widget":false,"key_public":"","org_name":"","project_name":"","languages":[]},"url":"https://ror.org","versions":[{"_id":"6058e47681775f002de04837","version":"1","version_clean":"1.0.0","codename":"","is_stable":true,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["6058e47681775f002de04839","6058e47681775f002de04839","6058e47681775f002de0483f","60d3d003d5ef44000f12c6c5","60de178b3321e40069edd8ac","63581e7c2875a60bd7564745","6376be56127d99000315eda9","64426d364b8f4c00604bb504","653c1e6f1cd9f1004b55cc72","65ec6c03aff86d0072a566d7"],"project":"6058e47681775f002de04832","releaseDate":"2021-03-22T18:39:50.198Z","createdAt":"2021-03-22T18:39:50.198Z","__v":2,"updatedAt":"2024-04-11T20:46:41.458Z"},{"_id":"66072096d9631f0054e8c118","version":"2","version_clean":"2.0.0","codename":"","is_stable":false,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["6058e47681775f002de04839","6058e47681775f002de04839","66072096d9631f0054e8c0ea","60d3d003d5ef44000f12c6c5","60de178b3321e40069edd8ac","63581e7c2875a60bd7564745","6376be56127d99000315eda9","66072096d9631f0054e8c0ee","66072096d9631f0054e8c0ef","66072096d9631f0054e8c0f0","66072097d9631f0054e8c11a"],"project":"6058e47681775f002de04832","releaseDate":"2021-03-22T18:39:50.198Z","createdAt":"2024-03-29T20:12:06.845Z","__v":0,"updatedAt":"2024-04-11T20:46:41.478Z","forked_from":"6058e47681775f002de04837"}],"variableDefaults":[],"webhookEnabled":false,"isHubEditable":true},"projectStore":{"data":{"allow_crawlers":"disabled","glossary":[{"_id":"6058e47681775f002de04833","term":"parliament","definition":"Owls are generally solitary, but when seen together the group is called a 'parliament'!"}],"canonical_url":null,"description":"Technical documentation for ROR, the Research Organization Registry, a global, community-led registry of open persistent identifiers for research organizations.","homepage_url":"https://ror.org","id":"6058e47681775f002de04832","name":"ROR","parent":null,"redirects":[],"sitemap":"disabled","subdomain":"ror","suggested_edits":"enabled","uri":"/projects/me","variable_defaults":[],"webhooks":[],"api_designer":{"allow_editing":"enabled"},"custom_login":{"login_url":null,"logout_url":null},"features":{"custom_components":"disabled","mdx":"disabled"},"onboarding_completed":{"api":true,"appearance":true,"documentation":true,"domain":false,"jwt":false,"logs":false,"metricsSDK":false},"pages":{"not_found":null},"privacy":{"view":"public","password":null},"refactored":{"status":"disabled","migrated":"unknown"},"reference":{"api_sdk_snippets":"enabled","defaults":"always_use","json_editor":"disabled","oauth_flows":"disabled","request_history":"enabled","response_examples":"collapsed","response_schemas":"collapsed"},"seo":{"overwrite_title_tag":"enabled"},"plan":{"type":"opensource","grace_period":{"enabled":false,"end_date":null},"trial":{"expired":false,"end_date":"2021-04-05T18:39:50.145Z"}},"health_check":{"provider":"none","settings":{"manual":{"status":"down","url":null},"statuspage":{"id":null}}},"integrations":{"aws":{"readme_webhook_login":{"region":null,"external_id":null,"role_arn":null,"usage_plan_id":null}},"bing":{"verify":null},"google":{"analytics":null,"site_verification":null},"heap":{"id":null},"koala":{"key":null},"localize":{"key":null},"recaptcha":{"site_key":null,"secret_key":null},"segment":{"key":null,"domain":null},"typekit":{"key":null},"zendesk":{"subdomain":null},"intercom":{"app_id":null,"secure_mode":{"key":null,"email_only":false}}},"permissions":{"appearance":{"private_label":"disabled","custom_code":{"css":"enabled","html":"disabled","js":"disabled"}}},"appearance":{"brand":{"primary_color":"#44A28F","link_color":null,"theme":"light"},"changelog":{"layout":"collapsed","show_author":true,"show_exact_date":false},"markdown":{"callouts":{"icon_font":"emojis"}},"table_of_contents":"enabled","whats_next_label":"Other resources you might find helpful","footer":{"readme_logo":"show"},"logo":{"size":"large","dark_mode":{"uri":null,"url":"https://files.readme.io/dacd566-white-logo.png","name":"dacd566-white-logo.png","width":125,"height":80,"color":"#ffffff","links":{"original_url":null}},"main":{"uri":"/images/6762cc61aa21d600184034d9","url":"https://files.readme.io/4680beec6938bde00138451225326037ace6f6e8011c88b92e902c051dfb922e-small-ror-logo-2600px.png","name":"4680beec6938bde00138451225326037ace6f6e8011c88b92e902c051dfb922e-small-ror-logo-2600px.png","width":136,"height":80,"color":"#242c24","links":{"original_url":"https://files.readme.io/044ba45b93ac5dedcb918fd8280e53ec0243dd1b04b9edaed5ba61d09283f7b7-ror-logo-2600px.png"}},"favicon":{"uri":null,"url":"https://files.readme.io/a931430-small-ror-icon-profile_2.png","name":"ror-icon-profile (2).png","width":32,"height":32,"color":"#d8e0de","links":{"original_url":"https://files.readme.io/a2115cf-ror-icon-profile_2.png"}}},"custom_code":{"css":null,"js":null,"html":{"header":null,"home_footer":null,"page_footer":null}},"header":{"type":"solid","gradient_color":null,"overlay":{"fill":"auto","type":"triangles","position":"top-left","image":{"uri":null,"url":null,"name":null,"width":null,"height":null,"color":null,"links":{"original_url":null}}}},"navigation":{"first_page":"landing_page","left":[{"type":"link_url","title":"Report a bug or request a feature","url":"https://github.com/ror-community/ror-roadmap/issues/new/choose","custom_page":null},{"type":"link_url","title":"Contact support","url":"mailto:support@ror.org","custom_page":null}],"logo_link":"homepage","right":[{"type":"user_controls","title":null,"url":null,"custom_page":null}],"sub_nav":[],"subheader_layout":"links","version":"enabled","links":{"home":{"label":"Home","visibility":"enabled"},"graphql":{"label":"GraphQL","visibility":"disabled"},"guides":{"label":"Guides","alias":null,"visibility":"enabled"},"reference":{"label":"API Reference","alias":null,"visibility":"disabled"},"recipes":{"label":"Recipes","alias":null,"visibility":"disabled"},"changelog":{"label":"Changelog","alias":null,"visibility":"enabled"},"discussions":{"label":"Discussions","alias":null,"visibility":"disabled"}}}}}},"version":{"_id":"6058e47681775f002de04837","version":"1","version_clean":"1.0.0","codename":"","is_stable":true,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["6058e47681775f002de04839","6058e47681775f002de04839","6058e47681775f002de0483f","60d3d003d5ef44000f12c6c5","60de178b3321e40069edd8ac","63581e7c2875a60bd7564745","6376be56127d99000315eda9","64426d364b8f4c00604bb504","653c1e6f1cd9f1004b55cc72","65ec6c03aff86d0072a566d7"],"project":"6058e47681775f002de04832","releaseDate":"2021-03-22T18:39:50.198Z","createdAt":"2021-03-22T18:39:50.198Z","__v":2,"updatedAt":"2024-04-11T20:46:41.458Z"}},"reqUrl":"/docs/matching","version":{"_id":"6058e47681775f002de04837","version":"1","version_clean":"1.0.0","codename":"","is_stable":true,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["6058e47681775f002de04839","6058e47681775f002de04839","6058e47681775f002de0483f","60d3d003d5ef44000f12c6c5","60de178b3321e40069edd8ac","63581e7c2875a60bd7564745","6376be56127d99000315eda9","64426d364b8f4c00604bb504","653c1e6f1cd9f1004b55cc72","65ec6c03aff86d0072a566d7"],"project":"6058e47681775f002de04832","releaseDate":"2021-03-22T18:39:50.198Z","createdAt":"2021-03-22T18:39:50.198Z","__v":2,"updatedAt":"2024-04-11T20:46:41.458Z"},"lang":"en","langFull":"Default","isDetachedProductionSite":false}"></script></div><div id="hub-container"><div class="hub-container"><div state-container ng-attr-id="{{state.current().root !== 'docs' && 'react-app-content-container'}}"><div id="replace-view" ng-non-bindable></div></div></div></div><script>var is_hub = true; var is_hub2 = true; var is_hub_edit = true; </script><div id="ssr-end"><script id="__LOADABLE_REQUIRED_CHUNKS__" type="application/json">[6601,3622,9772,4904,7449,7372,9082,734,954,6903,2395,6522,6471,1095,777,5753,2852,9930,7783,1456,4935,4287,5948,4201,8230,1313,1343,5798,1666,1936,8063,6060,4002,1525,3787,6922,2447,4467,5408,2637,4674,1731,4793,2616,3412,3221,7327,7285,3307,9575,7356,1202,2402,2144,9141,1080,9852,8684,678,3859,3556,2578,3626,7031,8899,7779,7289,1231,3826,1813,2790,2705,169,2548,2183,4778]</script><script id="__LOADABLE_REQUIRED_CHUNKS___ext" type="application/json">{"namedChunks":["routes-SuperHub","Header","core-icons-chevron-up-down-svg","routes-Reference","core-icons-more-vertical-svg","Footer","routes-PageNotFound","routes-Doc","core-icons-arrow-up-right-svg","core-icons-lock-svg","routes-Landing","CustomPage","routes-Tutorials","routes-Discuss","List","core-icons-star-svg","core-icons-trending-up-svg","core-icons-callout-info-svg","core-icons-search-svg","core-icons-custom-pages-svg","routes-SuperHub-Routes","core-icons-arrow-right-svg","RMDX","core-icons-alert-circle-svg","Page","routes-Changelog","Post","routes-CustomPage","Editor","core-icons-x-circle-svg","core-icons-suggested-edits-svg","core-icons-webhook-svg","core-icons-chevron-down-svg","core-icons-key-svg","core-icons-eye-off-svg","core-icons-book-svg","core-icons-message-circle-svg","New","core-icons-gauge-circle-svg","core-icons-inbox-svg","routes-Dash-ChatGPT-CopilotInstalledPage","core-icons-unlock-svg","core-icons-alert-triangle-svg","core-icons-chevron-right-svg","core-icons-plus-svg","core-icons-folder-plus-svg","core-icons-file-svg","core-icons-eye-svg"]}</script> <script async data-chunk="main" src="https://cdn.readme.io/public/hub/web/main.8f0f9842d9d694d25653.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/6601.cef2fa12a9b5e2b9df03.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/3622.30b9cb2443fabb238262.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/9772.ff8569d00b013c692975.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/4904.df63e6b74f3878787175.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/7449.dae0332305a8704415a6.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/7372.aa4569536a36087cf4a9.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/9082.f9fa9ec2b80af1ef61bd.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/734.2949e3d7010fa5c21ffd.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/954.3489f00e90e7627e0a4f.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/6903.75b9333e2c99d6924d0e.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/2395.2e57fd05aa65fe956c0d.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/6522.ccf876992083e861c716.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/6471.9b6a78348f451ad7179f.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/1095.b595bea4632cd7baf7d3.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/777.ef77d501263107e85d40.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/5753.cf11ea4f8d4c552b72f2.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/routes-SuperHub.9e8cc6b3b1eb13756c87.js"></script> <script async data-chunk="Header" src="https://cdn.readme.io/public/hub/web/9930.8ac6b4156bf4ee8644e6.js"></script> <script async data-chunk="Header" src="https://cdn.readme.io/public/hub/web/7783.fdde3006d3bddb71d71f.js"></script> <script async data-chunk="Header" src="https://cdn.readme.io/public/hub/web/Header.f647f7f0ae63a468ff05.js"></script> <script async data-chunk="core-icons-chevron-up-down-svg" src="https://cdn.readme.io/public/hub/web/core-icons-chevron-up-down-svg.6aae957df71e6f4c5e24.js"></script> <script async data-chunk="routes-Reference" src="https://cdn.readme.io/public/hub/web/4287.916cdd386055d2c5d238.js"></script> <script async data-chunk="routes-Reference" src="https://cdn.readme.io/public/hub/web/5948.a51402657e2eb40ab43b.js"></script> <script async data-chunk="routes-Reference" src="https://cdn.readme.io/public/hub/web/4201.0dcb58fab6c4005e3490.js"></script> <script async data-chunk="routes-Reference" src="https://cdn.readme.io/public/hub/web/8230.205a1750fac29d9c2b33.js"></script> <script async data-chunk="routes-Reference" src="https://cdn.readme.io/public/hub/web/routes-Reference.56680627529013bc5655.js"></script> <script async data-chunk="core-icons-more-vertical-svg" src="https://cdn.readme.io/public/hub/web/core-icons-more-vertical-svg.4822b3f831e11095980d.js"></script> <script async data-chunk="Footer" src="https://cdn.readme.io/public/hub/web/Footer.8514b725f5cc2d3b093c.js"></script> <script async data-chunk="routes-PageNotFound" src="https://cdn.readme.io/public/hub/web/routes-PageNotFound.a7fc6699ce547c746349.js"></script> <script async data-chunk="routes-Doc" src="https://cdn.readme.io/public/hub/web/routes-Doc.77726690b2730b652fcc.js"></script> <script async data-chunk="core-icons-arrow-up-right-svg" src="https://cdn.readme.io/public/hub/web/core-icons-arrow-up-right-svg.8ec73f7e322d79a2695b.js"></script> <script async data-chunk="core-icons-lock-svg" src="https://cdn.readme.io/public/hub/web/core-icons-lock-svg.70942d3ee6bad6267696.js"></script> <script async data-chunk="routes-Landing" src="https://cdn.readme.io/public/hub/web/4002.704e628347d37011965d.js"></script> <script async data-chunk="routes-Landing" src="https://cdn.readme.io/public/hub/web/1525.14392173bbb8515a4952.js"></script> <script async data-chunk="routes-Landing" src="https://cdn.readme.io/public/hub/web/routes-Landing.b95f6aef50c6c4b838ab.js"></script> <script async data-chunk="CustomPage" src="https://cdn.readme.io/public/hub/web/6922.e8247ef6931a72e55b3e.js"></script> <script async data-chunk="CustomPage" src="https://cdn.readme.io/public/hub/web/CustomPage.dc3b5b02d7c889ec94bf.js"></script> <script async data-chunk="routes-Tutorials" src="https://cdn.readme.io/public/hub/web/routes-Tutorials.13fce08dd6ce7450aa5c.js"></script> <script async data-chunk="routes-Discuss" src="https://cdn.readme.io/public/hub/web/routes-Discuss.767eaf4d840eff595fe5.js"></script> <script async data-chunk="List" src="https://cdn.readme.io/public/hub/web/2637.f161cf21b4202fcf0f18.js"></script> <script async data-chunk="List" src="https://cdn.readme.io/public/hub/web/4674.95030b896e483d287f2e.js"></script> <script async data-chunk="List" src="https://cdn.readme.io/public/hub/web/List.c3e7d6a183b1f2ad779c.js"></script> <script async data-chunk="core-icons-star-svg" src="https://cdn.readme.io/public/hub/web/core-icons-star-svg.b834e1612cb2af1e174e.js"></script> <script async data-chunk="core-icons-trending-up-svg" src="https://cdn.readme.io/public/hub/web/core-icons-trending-up-svg.0dd920b0698e57f75afa.js"></script> <script async data-chunk="core-icons-callout-info-svg" src="https://cdn.readme.io/public/hub/web/core-icons-callout-info-svg.79b14e8568c9cecbc827.js"></script> <script async data-chunk="core-icons-search-svg" src="https://cdn.readme.io/public/hub/web/core-icons-search-svg.ad9cac962958d30983a7.js"></script> <script async data-chunk="core-icons-custom-pages-svg" src="https://cdn.readme.io/public/hub/web/core-icons-custom-pages-svg.444e514638d9afbec182.js"></script> <script async data-chunk="routes-SuperHub-Routes" src="https://cdn.readme.io/public/hub/web/7285.703d773b1bb63ae6e7ee.js"></script> <script async data-chunk="routes-SuperHub-Routes" src="https://cdn.readme.io/public/hub/web/routes-SuperHub-Routes.7f0f17c99d42871fe2fb.js"></script> <script async data-chunk="core-icons-arrow-right-svg" src="https://cdn.readme.io/public/hub/web/core-icons-arrow-right-svg.eadb74658f93b4e7d75f.js"></script> <script async data-chunk="RMDX" src="https://cdn.readme.io/public/hub/web/RMDX.69369bc391183526305f.js"></script> <script async data-chunk="core-icons-alert-circle-svg" src="https://cdn.readme.io/public/hub/web/core-icons-alert-circle-svg.4cee8264c97045599b56.js"></script> <script async data-chunk="Page" src="https://cdn.readme.io/public/hub/web/Page.91ab5df2f5275ac772af.js"></script> <script async data-chunk="routes-Changelog" src="https://cdn.readme.io/public/hub/web/routes-Changelog.cbaec12bbdd9e5fad9a5.js"></script> <script async data-chunk="Post" src="https://cdn.readme.io/public/hub/web/Post.922078b47615946064e5.js"></script> <script async data-chunk="Editor" src="https://cdn.readme.io/public/hub/web/Editor.bfd7979c3ede22ebb6ef.js"></script> <script async data-chunk="core-icons-x-circle-svg" src="https://cdn.readme.io/public/hub/web/core-icons-x-circle-svg.abc0e0ea5b7f9dff667c.js"></script> <script async data-chunk="core-icons-suggested-edits-svg" src="https://cdn.readme.io/public/hub/web/core-icons-suggested-edits-svg.8d2d8ac2fd22ded9238d.js"></script> <script async data-chunk="core-icons-webhook-svg" src="https://cdn.readme.io/public/hub/web/core-icons-webhook-svg.fe540ea1c09e1c0e0247.js"></script> <script async data-chunk="core-icons-chevron-down-svg" src="https://cdn.readme.io/public/hub/web/core-icons-chevron-down-svg.e20b84e9871bd73d1b8c.js"></script> <script async data-chunk="core-icons-key-svg" src="https://cdn.readme.io/public/hub/web/core-icons-key-svg.71e09670b926900508b8.js"></script> <script async data-chunk="core-icons-eye-off-svg" src="https://cdn.readme.io/public/hub/web/core-icons-eye-off-svg.b2b8b241b4b324dfd9c1.js"></script> <script async data-chunk="core-icons-book-svg" src="https://cdn.readme.io/public/hub/web/core-icons-book-svg.556c5a2abddd44b2284c.js"></script> <script async data-chunk="core-icons-message-circle-svg" src="https://cdn.readme.io/public/hub/web/core-icons-message-circle-svg.1e24c2d2eb4f9a6ede5d.js"></script> <script async data-chunk="New" src="https://cdn.readme.io/public/hub/web/New.809992a323beb6b1920f.js"></script> <script async data-chunk="core-icons-gauge-circle-svg" src="https://cdn.readme.io/public/hub/web/core-icons-gauge-circle-svg.fff25782546fef314a09.js"></script> <script async data-chunk="core-icons-inbox-svg" src="https://cdn.readme.io/public/hub/web/core-icons-inbox-svg.01c2ecb759e417a98bb8.js"></script> <script async data-chunk="routes-Dash-ChatGPT-CopilotInstalledPage" src="https://cdn.readme.io/public/hub/web/1231.f80a04007595f4936e51.js"></script> <script async data-chunk="routes-Dash-ChatGPT-CopilotInstalledPage" src="https://cdn.readme.io/public/hub/web/routes-Dash-ChatGPT-CopilotInstalledPage.62a9fb1d734b15803ce5.js"></script> <script async data-chunk="core-icons-unlock-svg" src="https://cdn.readme.io/public/hub/web/core-icons-unlock-svg.d27591cc9e0be731e26d.js"></script> <script async data-chunk="core-icons-alert-triangle-svg" src="https://cdn.readme.io/public/hub/web/core-icons-alert-triangle-svg.aa5960e73a548f38e8bd.js"></script> <script async data-chunk="core-icons-chevron-right-svg" src="https://cdn.readme.io/public/hub/web/core-icons-chevron-right-svg.34d126524d8ea236d174.js"></script> <script async data-chunk="core-icons-plus-svg" src="https://cdn.readme.io/public/hub/web/core-icons-plus-svg.a49fb76ac2661b5e1c7e.js"></script> <script async data-chunk="core-icons-folder-plus-svg" src="https://cdn.readme.io/public/hub/web/core-icons-folder-plus-svg.2c200438e59611867262.js"></script> <script async data-chunk="core-icons-file-svg" src="https://cdn.readme.io/public/hub/web/core-icons-file-svg.24d3e20044ef331cf0d2.js"></script> <script async data-chunk="core-icons-eye-svg" src="https://cdn.readme.io/public/hub/web/core-icons-eye-svg.b2103692a3c209893efe.js"></script></div><script id="hub-me" type="application/json" data-json="{"loggedIn":false,"search":{"app":"T28YKFATPY","token":"ODczNzdiMDdiZDc1ZWRiOGQyYWVlYzVjMTdiMjg3ZmEwNWUyZDk3YWJlMDc5ZTliNmFhNTE2ZWY3ZDhiOGUyZnRhZ0ZpbHRlcnM9KHByb2plY3Q6NjA1OGU0NzY4MTc3NWYwMDJkZTA0ODMyKSwodmVyc2lvbjpub25lLHZlcnNpb246NjA1OGU0NzY4MTc3NWYwMDJkZTA0ODM3KSwoaGlkZGVuOm5vbmUsaGlkZGVuOmZhbHNlKSwoaW5kZXg6Q3VzdG9tUGFnZSxpbmRleDpQYWdlLGluZGV4OkJsb2cp","filters":"tagFilters=(project:6058e47681775f002de04832),(version:none,version:6058e47681775f002de04837),(hidden:none,hidden:false),(index:CustomPage,index:Page,index:Blog)","metaData":[{"modules":{"landing":true,"docs":true,"examples":false,"reference":false,"changelog":true,"discuss":false,"suggested_edits":true,"logs":false,"custompages":false,"tutorials":false,"graphql":false},"id":"6058e47681775f002de04832","name":"ROR","subdomain":"ror","subpath":"","nav_names":{"docs":"","reference":"","changelog":"","discuss":"","tutorials":"","recipes":""}}]}}"></script><script id="readme-data-baseUrl" type="application/json" data-json=""/""></script></body></html>

CINXE.COM

Match organization names to ROR IDs