CINXE.COM
Map other organization IDs 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?1732290089794"></script><meta charset="utf-8"><meta http-equiv="X-UA-Compatible" content="IE=edge"><meta name="readme-deploy" content="5.235.0"><meta name="readme-subdomain" content="ror"><meta name="readme-version" content="1"><title>Map other organization IDs to ROR IDs</title><meta name="description" content="This document explains how to map other organization IDs to ROR IDs using the ROR API or data dump, including tips for implementation and specific use cases like migrating from GRID to ROR."><meta property="og:title" content="Map other organization IDs to ROR IDs"><meta property="og:description" content="This document explains how to map other organization IDs to ROR IDs using the ROR API or data dump, including tips for implementation and specific use cases like migrating from GRID to ROR."><meta property="og:site_name" content="ROR"><meta name="twitter:title" content="Map other organization IDs to ROR IDs"><meta name="twitter:description" content="This document explains how to map other organization IDs to ROR IDs using the ROR API or data dump, including tips for implementation and specific use cases like migrating from GRID to ROR."><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/4330c08-small-ror-logo-large.png"><meta name="twitter:image" content="https://files.readme.io/4330c08-small-ror-logo-large.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/mapping"><script src="https://cdn.readme.io/public/js/cash-dom.min.js?1732290089794"></script><link data-chunk="Page" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/Page.f8e4e9e20d429e588f3c.css"> <link data-chunk="List" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/List.8b6b887d01c2343868e8.css"> <link data-chunk="routes-Discuss" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/routes-Discuss.8f79ff8c1099c5933136.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="routes-SuperHub-Routes" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/routes-SuperHub-Routes.394c4b2f8910cf363781.css"> <link data-chunk="Editor" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/Editor.c9adabeec62cc7e2bd7a.css"> <link data-chunk="CustomPage" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/CustomPage.38a39d6ce8b0e2afad5a.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.087102afd3bca3215f45.css"> <link data-chunk="routes-Landing" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/routes-Landing.c5ea43d2f4b3b926ff1f.css"> <link data-chunk="routes-Doc" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/routes-Doc.921b58c17b447c4e783e.css"> <link data-chunk="Header" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/Header.1c46140f4fda4e981a8d.css"> <link data-chunk="routes-SuperHub" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/routes-SuperHub.db8b3beb03eead84c21e.css"> <link data-chunk="routes-SuperHub" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/8263.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.2415ba38e8e5c2ba190e.css"> <link data-chunk="main" rel="preload" as="style" href="https://cdn.readme.io/public/hub/web/ui-styles.a5d24742a3656724b61d.css"> <link data-chunk="main" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/main.766cf20fa350c2c18107.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/6859.fc1496da022e612abe33.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/1802.00a1e88cc0d9da2aae1b.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/9772.1912e092b9c8785ff5c3.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/3284.6ecd6ef27e2009d3fdc7.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/572.bab1eda8453360a8a761.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/5312.ca2c08ec1b75bb03c21e.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/5548.8fb1bb5d57de6c263c67.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/2395.6288c030d5183baa5a89.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/6522.057d8ea587133ae98687.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/7112.69c3d611e7e54e411b26.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/4608.3b5a227647e78e858c3f.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/8263.a563779273b90f66c0db.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/1282.591f476c316bf3670bbd.js"> <link data-chunk="routes-SuperHub" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/routes-SuperHub.a3bb3020bf29f8f67ef8.js"> <link data-chunk="Header" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/3880.3892311d81c548cb073c.js"> <link data-chunk="Header" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/7783.48ca7ef3a5c469d97e53.js"> <link data-chunk="Header" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/Header.ad57d9fcd570c04fb712.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-Doc" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/6841.587d285d41ca8bab11b1.js"> <link data-chunk="routes-Doc" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/6722.e485c5aa155bd0f0ccf8.js"> <link data-chunk="routes-Doc" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/routes-Doc.e3a4e0817a9a640436bc.js"> <link data-chunk="Footer" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/Footer.eb98b86c4279989f5a59.js"> <link data-chunk="routes-Landing" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/4002.08d1caef58d08eaccd19.js"> <link data-chunk="routes-Landing" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/routes-Landing.f0816876bdfbbc06801a.js"> <link data-chunk="routes-Reference" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/7971.db270c2970b791e38435.js"> <link data-chunk="routes-Reference" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/153.e4db5a313c7d51383015.js"> <link data-chunk="routes-Reference" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/routes-Reference.d66a49f09580aafdabb6.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="routes-PageNotFound" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/routes-PageNotFound.84a460336ee9c83a7d55.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/2859.94b03b9a9585460aa921.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="Editor" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/Editor.002979730c36f9c65ad3.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-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="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="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-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-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-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.5ccfbee71da134a1eeba.js"> <link data-chunk="routes-Changelog" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/routes-Changelog.3f125a62ed05cc53aec4.js"> <link data-chunk="Post" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/Post.cced33af5051de7f473f.js"> <link data-chunk="rmdx" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/rmdx.594ae0fac8012b876a80.js"> <link data-chunk="routes-Discuss" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/routes-Discuss.6a5b69949f194448cf4f.js"> <link data-chunk="List" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/2637.a5df1d5e240762d7981f.js"> <link data-chunk="List" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/4674.13378da16ce7b5beba66.js"> <link data-chunk="List" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/List.12cee315afa198c8e23e.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="Page" rel="preload" as="script" href="https://cdn.readme.io/public/hub/web/Page.65c6f721688901333944.js"> <link data-chunk="main" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/ui-styles.a5d24742a3656724b61d.css"> <link data-chunk="main" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/main.2415ba38e8e5c2ba190e.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/8263.75e3fc491ee8103c63a3.css"> <link data-chunk="routes-SuperHub" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/routes-SuperHub.db8b3beb03eead84c21e.css"> <link data-chunk="Header" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/Header.1c46140f4fda4e981a8d.css"> <link data-chunk="routes-Doc" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/routes-Doc.921b58c17b447c4e783e.css"> <link data-chunk="routes-Landing" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/routes-Landing.c5ea43d2f4b3b926ff1f.css"> <link data-chunk="routes-Reference" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/routes-Reference.087102afd3bca3215f45.css"> <link data-chunk="routes-PageNotFound" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/routes-PageNotFound.d8afd1171cf7a455eed7.css"> <link data-chunk="CustomPage" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/CustomPage.38a39d6ce8b0e2afad5a.css"> <link data-chunk="Editor" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/Editor.c9adabeec62cc7e2bd7a.css"> <link data-chunk="routes-SuperHub-Routes" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/routes-SuperHub-Routes.394c4b2f8910cf363781.css"> <link data-chunk="routes-Changelog" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/routes-Changelog.28957affcff81e852361.css"> <link data-chunk="routes-Discuss" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/routes-Discuss.8f79ff8c1099c5933136.css"> <link data-chunk="List" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/List.8b6b887d01c2343868e8.css"> <link data-chunk="Page" rel="stylesheet" href="https://cdn.readme.io/public/hub/web/Page.f8e4e9e20d429e588f3c.css"><!-- CUSTOM 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:63px;height:40px;margin-top:0;background-image:url(https://files.readme.io/4330c08-small-ror-logo-large.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.235.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/4330c08-small-ror-logo-large.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="/cdn-cgi/l/email-protection#94e7e1e4e4fbe6e0d4e6fbe6bafbe6f3" 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="/cdn-cgi/l/email-protection#05767075756a777145776a772b6a7762" 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/mapping" target="_self" to="/login?redirect_uri=/docs/mapping">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/4330c08-small-ror-logo-large.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/mapping" 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" 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>v<!-- -->1</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">Map other organization IDs 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" 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/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></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">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 class="Sidebar-link2Dsha-r-GKh2 childless text-wrap rm-Sidebar-link" 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 aria-current="page" class="Sidebar-link2Dsha-r-GKh2 childless text-wrap rm-Sidebar-link active" 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>Map other organization IDs to ROR IDs</h1></div><div class="col-xs-3"><a class="suggestEdits" rel="nofollow" href="/edit/mapping"><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>Many ROR records contain equivalent organization IDs of other types in the <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> section. This allows you to find the equivalent ROR ID for several other organization ID types. </p> <p>Organization ID types you&#x27;ll find in ROR records include:</p> <ul> <li>Crossref Funder ID (formerly FundRef)</li> <li>GRID</li> <li>ISNI</li> <li>Wikidata</li> </ul> <p>Not all records contain all of the ID types above in <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>. In some cases, an equivalent ID may not exist in that identifier type. </p> <blockquote class="callout callout_info" theme="📘"><h2 class="callout-heading"><span class="callout-icon">📘</span><p>Migrating from GRID to ROR</p></h2><p><strong>GRID published its final public release on 16 Sep 2021</strong> (see <a href="/docs/grid" target="" title="" class="doc-link" data-sidebar="grid">GRID/ROR Transition FAQ</a>) </p><p>If you&#x27;re migrating to ROR from GRID, the good news is that <a href="/docs/data-structure" target="" title="" class="doc-link" data-sidebar="data-structure">ROR&#x27;s JSON data structure</a> is identical to GRID&#x27;s <em>and</em> every GRID ID has a one-to-one match to a ROR ID!</p><p>The latest ROR data is available from Zenodo rather than Figshare, however, so if you&#x27;ve been using the Figshare API to import GRID data, you&#x27;ll need to switch to <a href="/docs/data-dump#download-ror-data-dumps-programmatically-with-the-zenodo-api" target="" title="" class="doc-link" data-sidebar="data-dump#download-ror-data-dumps-programmatically-with-the-zenodo-api">downloading the ROR data dump using the Zenodo API</a>.</p><p>You can also find a list of ROR IDs and their equivalent GRID IDs from the Sep 2021 ROR data dump as a CSV file at <a href="https://doi.org/10.5281/zenodo.5534785" target="" title="">https://doi.org/10.5281/zenodo.5534785</a></p></blockquote> <h2 class="heading heading-2 header-scroll" align=""><div class="heading-anchor anchor waypoint" id="map-other-ids-to-ror-using-the-api"></div><div class="heading-text"><div id="section-map-other-i-ds-to-ror-using-the-api" class="heading-anchor_backwardsCompatibility"></div>Map other IDs to ROR using the API</div><a aria-label="Skip link to Map other IDs to ROR using the API" class="heading-anchor-icon fa fa-anchor" href="#map-other-ids-to-ror-using-the-api"></a></h2> <blockquote class="callout callout_info" theme="📘"><h2 class="callout-heading empty"><span class="callout-icon">📘</span></h2><p>This guide provides tips for implementing the ROR API for this specific use case. See the <a href="/docs/rest-api" target="" title="" class="doc-link" data-sidebar="rest-api">REST API guide</a> for full information about the ROR API.</p></blockquote> <h3 class="heading heading-3 header-scroll" align=""><div class="heading-anchor anchor waypoint" id="map-a-single-id-to-ror"></div><div class="heading-text"><div id="section-map-a-single-id-to-ror" class="heading-anchor_backwardsCompatibility"></div>Map a single ID to ROR</div><a aria-label="Skip link to Map a single ID to ROR" class="heading-anchor-icon fa fa-anchor" href="#map-a-single-id-to-ror"></a></h3> <p>Search for a ROR record containing an equivalent ID of another type in external_ids by using quotes around the ID in a query. </p> <p>The query parameter search approach includes the external_ids field and so can be used to search for ROR records that match an external identifier. Use URL-encoded quotation marks before and after the identifier search string for best results.</p> <p>Because the query parameter search does not search relationships fields, only the record with the searched-for identifier in the external_ids field will be returned.</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/organizations?query=%22grid.14003.36%22 | json_pp -json_opt pretty,utf8 </code></pre></div></div> <p>If a match is found, the response will contain 1 or more full ROR records. You&#x27;ll find the corresponding ROR ID(s) in <button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">items[n].id.</code></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;acronyms&quot; : [ &quot;UW&quot; ], &quot;addresses&quot; : [ { &quot;city&quot; : &quot;Madison&quot;, &quot;country_geonames_id&quot; : 6252001, &quot;geonames_city&quot; : { &quot;city&quot; : &quot;Madison&quot;, &quot;geonames_admin1&quot; : { &quot;ascii_name&quot; : &quot;Wisconsin&quot;, &quot;code&quot; : &quot;US.WI&quot;, &quot;id&quot; : 5279468, &quot;name&quot; : &quot;Wisconsin&quot; }, &quot;geonames_admin2&quot; : { &quot;ascii_name&quot; : &quot;Dane&quot;, &quot;code&quot; : &quot;US.WI.025&quot;, &quot;id&quot; : 5250074, &quot;name&quot; : &quot;Dane&quot; }, &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; : &quot;&quot;, &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;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;OrgRef&quot; : { &quot;all&quot; : [ &quot;23536538&quot;, &quot;2429663&quot;, &quot;10260206&quot; ], &quot;preferred&quot; : &quot;23536538&quot; }, &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;fr&quot;, &quot;label&quot; : &quot;Université du Wisconsin à Madison&quot; }, { &quot;iso639&quot; : &quot;es&quot;, &quot;label&quot; : &quot;Universidad de 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/03ydkyb10&quot;, &quot;label&quot; : &quot;University of Wisconsin System&quot;, &quot;type&quot; : &quot;Parent&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/03b8vas82&quot;, &quot;label&quot; : &quot;National Atmospheric Deposition Program&quot;, &quot;type&quot; : &quot;Related&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;status&quot; : &quot;active&quot;, &quot;types&quot; : [ &quot;Education&quot; ], &quot;wikipedia_url&quot; : &quot;http://en.wikipedia.org/wiki/University_of_Wisconsin%E2%80%93Madison&quot; } ], &quot;meta&quot; : { &quot;countries&quot; : [ { &quot;count&quot; : 1, &quot;id&quot; : &quot;us&quot;, &quot;title&quot; : &quot;United States&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;education&quot;, &quot;title&quot; : &quot;Education&quot; } ] }, &quot;number_of_results&quot; : 1, &quot;time_taken&quot; : 7 } </code></pre></div></div> <h3 class="heading heading-3 header-scroll" align=""><div class="heading-anchor anchor waypoint" id="map-a-list-of-ids-to-ror"></div><div class="heading-text"><div id="section-map-a-list-of-i-ds-to-ror" class="heading-anchor_backwardsCompatibility"></div>Map a list of IDs to ROR</div><a aria-label="Skip link to Map a list of IDs to ROR" class="heading-anchor-icon fa fa-anchor" href="#map-a-list-of-ids-to-ror"></a></h3> <p>If you have a list of other IDs you&#x27;d like to map to ROR, automate this search with a script. See our <a href="https://github.com/ror-community/ror-utilities" target="" title="">ror-utilities GitHub repository</a> for an example Python script that accepts a list of other IDs as a CSV file and returns a CSV file with corresponding ROR IDs.</p> <h3 class="heading heading-3 header-scroll" align=""><div class="heading-anchor anchor waypoint" id="mapping-tips"></div><div class="heading-text"><div id="section-mapping-tips" class="heading-anchor_backwardsCompatibility"></div>Mapping tips</div><a aria-label="Skip link to Mapping tips" class="heading-anchor-icon fa fa-anchor" href="#mapping-tips"></a></h3> <ul> <li>In <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>, each ID type has 2 fields: &quot;all&quot; and &quot;preferred&quot;. For many external IDs, &quot;preferred&quot; is null even when &quot;all&quot; has only 1 value, so we recommend that you <em>don&#x27;t</em> limit your mapping to only external IDs designated as preferred.</li> <li>Mapping many thousands of organizations using a script that calls the ROR API can take many hours. If you require a faster approach, you may want to use the <a href="/docs/data-dump" target="" title="" class="doc-link" data-sidebar="data-dump">data dump,</a> or an incremental approach, such as &quot;just in time&quot; mapping to ROR when organization data is read from or written to your system.</li> </ul> <h2 class="heading heading-2 header-scroll" align=""><div class="heading-anchor anchor waypoint" id="map-other-ids-to-ror-using-the-data-dump"></div><div class="heading-text"><div id="section-map-other-i-ds-to-ror-using-the-data-dump" class="heading-anchor_backwardsCompatibility"></div>Map other IDs to ROR using the data dump</div><a aria-label="Skip link to Map other IDs to ROR using the data dump" class="heading-anchor-icon fa fa-anchor" href="#map-other-ids-to-ror-using-the-data-dump"></a></h2> <p>You can also use the <a href="/docs/data-dump" target="" title="" class="doc-link" data-sidebar="data-dump">ROR data dump</a> to match other IDs to their equivalent ROR IDs using your own scripts or processing tools. 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="mapping-ringgold-ids-to-ror"></div><div class="heading-text"><div id="section-mapping-ringgold-i-ds-to-ror" class="heading-anchor_backwardsCompatibility"></div>Mapping Ringgold IDs to ROR</div><a aria-label="Skip link to Mapping Ringgold IDs to ROR" class="heading-anchor-icon fa fa-anchor" href="#mapping-ringgold-ids-to-ror"></a></h2> <p>Since Ringgold is a proprietary identifier system, we&#x27;re currently not able to include Ringgold IDs in ROR records. In the meantime, these approaches are available:</p> <ul> <li><strong>If you have access to the Ringgold Identify database/API</strong>, you can map Ringgold IDs to ROR IDs using ISNI as an intermediary, as ISNI IDs are included in both ROR and Ringgold records.</li> <li><strong>If you do not have access to the Ringgold Identify database/API</strong>, you may be able to map some Ringgold IDs to ROR IDs using Wikidata as an intermediary, as many ROR records contain Wikidata IDs and some Wikidata records contain Ringgold IDs that were derived from the 2019 ORCID public data file and published in <a href="http://doi.org/10.5281/zenodo.3241717" target="" title="">http://doi.org/10.5281/zenodo.3241717</a>. See the script at <a href="https://github.com/ror-community/ror-utilities/blob/main/general-scripts/map-ringgold-via-wikidata.py" target="" title="">https://github.com/ror-community/ror-utilities/blob/main/general-scripts/map-ringgold-via-wikidata.py</a> for a Python script that performs this matching.</li> </ul> <h2 class="heading heading-2 header-scroll" align=""><div class="heading-anchor anchor waypoint" id="other-external-identifiers"></div><div class="heading-text"><div id="section-other-external-identifiers" class="heading-anchor_backwardsCompatibility"></div>Other external identifiers</div><a aria-label="Skip link to Other external identifiers" class="heading-anchor-icon fa fa-anchor" href="#other-external-identifiers"></a></h2> <p>ROR&#x27;s current policy is to include only globally unique persistent identifiers as corresponding external IDs in ROR records, which means that national and regional identifiers such as UEI and PIC are not included. If you would benefit from having these or other identifiers in the ROR record, however, you may submit a schema change request on our <a href="https://github.com/ror-community/ror-roadmap" target="" title="">roadmap</a> or add a comment to an existing request. </p> <ul> <li><a href="https://github.com/ror-community/ror-roadmap/issues/97" target="" title="">Add European Union Participant Identifier Code (PIC)</a> - GitHub roadmap request for EU PIC mapping. Includes a link in the comments to a third-party-generated PIC-to-ROR mapping project that uses CORDIS data. </li> <li><a href="https://github.com/ror-community/ror-roadmap/issues/203" target="" title="">Add Unique Entity ID (UEI) tags as external IDs</a> - GitHub roadmap request for UEI mapping. Includes a third-party-generated spreadsheet in the comments that crosswalks over 950 SAM UEI, CAGE codes, DUNS numbers, and GRID IDs.</li> <li><a href="https://github.com/opensyllabus/institution-identifiers" target="" title="">US IPEDs mapping file</a> - GitHub repository from the <a href="https://www.opensyllabus.org/" target="" title="">OpenSyllabus</a> project with a CSV file that maps ROR IDs for records of type &quot;Education&quot; to GRID, Wikidata, and IPEDs identifiers.</li> <li><a href="https://docs.google.com/spreadsheets/d/e/2PACX-1vSWoD7q1vo4j8UC15ok2uC25DfUd87em1fihCMTXeSedK1U_wqn79VO1JqpiLrtI64kGKa3nyVlHxtz/pubhtml" target="" title="">RRID / SciCrunch ID to ROR mapping file</a> - Spreadsheet of mappings between SciCrunch IDs and ROR IDs as of July 2024.</li> </ul>" style="margin-left:31px" class="rm-Markdown markdown-body rm-Markdown markdown-body ng-non-bindable" data-testid="RDMD"><p>Many ROR records contain equivalent organization IDs of other types in the <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> section. This allows you to find the equivalent ROR ID for several other organization ID types. </p> <p>Organization ID types you'll find in ROR records include:</p> <ul> <li>Crossref Funder ID (formerly FundRef)</li> <li>GRID</li> <li>ISNI</li> <li>Wikidata</li> </ul> <p>Not all records contain all of the ID types above in <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>. In some cases, an equivalent ID may not exist in that identifier type. </p> <blockquote class="callout callout_info" theme="📘"><h2 class="callout-heading"><span class="callout-icon">📘</span><p>Migrating from GRID to ROR</p></h2><p><strong>GRID published its final public release on 16 Sep 2021</strong> (see <a target="_self" href="/docs/grid">GRID/ROR Transition FAQ</a>) </p><p>If you're migrating to ROR from GRID, the good news is that <a target="_self" href="/docs/data-structure">ROR's JSON data structure</a> is identical to GRID's <em>and</em> every GRID ID has a one-to-one match to a ROR ID!</p><p>The latest ROR data is available from Zenodo rather than Figshare, however, so if you've been using the Figshare API to import GRID data, you'll need to switch to <a target="_self" href="/docs/data-dump#download-ror-data-dumps-programmatically-with-the-zenodo-api">downloading the ROR data dump using the Zenodo API</a>.</p><p>You can also find a list of ROR IDs and their equivalent GRID IDs from the Sep 2021 ROR data dump as a CSV file at <a target="_self" href="https://doi.org/10.5281/zenodo.5534785">https://doi.org/10.5281/zenodo.5534785</a></p></blockquote> <h2 class="heading heading-2 header-scroll" align=""><div class="heading-anchor anchor waypoint" id="map-other-ids-to-ror-using-the-api"></div><div class="heading-text"><div id="section-map-other-i-ds-to-ror-using-the-api" class="heading-anchor_backwardsCompatibility"></div>Map other IDs to ROR using the API</div><a aria-label="Skip link to Map other IDs to ROR using the API" class="heading-anchor-icon fa fa-anchor" href="#map-other-ids-to-ror-using-the-api"></a></h2> <blockquote class="callout callout_info" theme="📘"><h2 class="callout-heading empty"><span class="callout-icon">📘</span></h2><p>This guide provides tips for implementing the ROR API for this specific use case. See the <a target="_self" href="/docs/rest-api">REST API guide</a> for full information about the ROR API.</p></blockquote> <h3 class="heading heading-3 header-scroll" align=""><div class="heading-anchor anchor waypoint" id="map-a-single-id-to-ror"></div><div class="heading-text"><div id="section-map-a-single-id-to-ror" class="heading-anchor_backwardsCompatibility"></div>Map a single ID to ROR</div><a aria-label="Skip link to Map a single ID to ROR" class="heading-anchor-icon fa fa-anchor" href="#map-a-single-id-to-ror"></a></h3> <p>Search for a ROR record containing an equivalent ID of another type in external_ids by using quotes around the ID in a query. </p> <p>The query parameter search approach includes the external_ids field and so can be used to search for ROR records that match an external identifier. Use URL-encoded quotation marks before and after the identifier search string for best results.</p> <p>Because the query parameter search does not search relationships fields, only the record with the searched-for identifier in the external_ids field will be returned.</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/organizations?query=%22grid.14003.36%22 | json_pp -json_opt pretty,utf8 </code></pre></div></div> <p>If a match is found, the response will contain 1 or more full ROR records. You'll find the corresponding ROR ID(s) in <button aria-label="Copy Code" class="rdmd-code-copy fa"></button><code class="rdmd-code lang- theme-light" data-lang="" name="" tabindex="0">items[n].id.</code></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" : [ { "acronyms" : [ "UW" ], "addresses" : [ { "city" : "Madison", "country_geonames_id" : 6252001, "geonames_city" : { "city" : "Madison", "geonames_admin1" : { "ascii_name" : "Wisconsin", "code" : "US.WI", "id" : 5279468, "name" : "Wisconsin" }, "geonames_admin2" : { "ascii_name" : "Dane", "code" : "US.WI.025", "id" : 5250074, "name" : "Dane" }, "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" : "", "established" : 1848, "external_ids" : { "FundRef" : { "all" : [ "100007015", "100008959", "100005996", "100007870", "100008301", "100008028", "100008237", "100008161", "100010495", "100009627", "100010284", "100005911", "100007925", "100005902" ], "preferred" : "100007015" }, "GRID" : { "all" : "grid.14003.36", "preferred" : "grid.14003.36" }, "ISNI" : { "all" : [ "0000 0001 2167 3675" ], "preferred" : null }, "OrgRef" : { "all" : [ "23536538", "2429663", "10260206" ], "preferred" : "23536538" }, "Wikidata" : { "all" : [ "Q838330", "Q33122195", "Q7662222" ], "preferred" : "Q838330" } }, "id" : "https://ror.org/01y2jtd41", "ip_addresses" : [], "labels" : [ { "iso639" : "fr", "label" : "Université du Wisconsin à Madison" }, { "iso639" : "es", "label" : "Universidad de Wisconsin-Madison" } ], "links" : [ "http://www.wisc.edu/" ], "name" : "University of Wisconsin–Madison", "relationships" : [ { "id" : "https://ror.org/03ydkyb10", "label" : "University of Wisconsin System", "type" : "Parent" }, { "id" : "https://ror.org/05cb4rb43", "label" : "Morgridge Institute for Research", "type" : "Child" }, { "id" : "https://ror.org/03b8vas82", "label" : "National Atmospheric Deposition Program", "type" : "Related" }, { "id" : "https://ror.org/04gq8q482", "label" : "North Temperate Lakes Long Term Ecological Research", "type" : "Child" } ], "status" : "active", "types" : [ "Education" ], "wikipedia_url" : "http://en.wikipedia.org/wiki/University_of_Wisconsin%E2%80%93Madison" } ], "meta" : { "countries" : [ { "count" : 1, "id" : "us", "title" : "United States" } ], "statuses" : [ { "count" : 1, "id" : "active", "title" : "active" } ], "types" : [ { "count" : 1, "id" : "education", "title" : "Education" } ] }, "number_of_results" : 1, "time_taken" : 7 } </code></pre></div></div> <h3 class="heading heading-3 header-scroll" align=""><div class="heading-anchor anchor waypoint" id="map-a-list-of-ids-to-ror"></div><div class="heading-text"><div id="section-map-a-list-of-i-ds-to-ror" class="heading-anchor_backwardsCompatibility"></div>Map a list of IDs to ROR</div><a aria-label="Skip link to Map a list of IDs to ROR" class="heading-anchor-icon fa fa-anchor" href="#map-a-list-of-ids-to-ror"></a></h3> <p>If you have a list of other IDs you'd like to map to ROR, automate this search with a script. See our <a target="_self" href="https://github.com/ror-community/ror-utilities">ror-utilities GitHub repository</a> for an example Python script that accepts a list of other IDs as a CSV file and returns a CSV file with corresponding ROR IDs.</p> <h3 class="heading heading-3 header-scroll" align=""><div class="heading-anchor anchor waypoint" id="mapping-tips"></div><div class="heading-text"><div id="section-mapping-tips" class="heading-anchor_backwardsCompatibility"></div>Mapping tips</div><a aria-label="Skip link to Mapping tips" class="heading-anchor-icon fa fa-anchor" href="#mapping-tips"></a></h3> <ul> <li>In <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>, each ID type has 2 fields: "all" and "preferred". For many external IDs, "preferred" is null even when "all" has only 1 value, so we recommend that you <em>don't</em> limit your mapping to only external IDs designated as preferred.</li> <li>Mapping many thousands of organizations using a script that calls the ROR API can take many hours. If you require a faster approach, you may want to use the <a target="_self" href="/docs/data-dump">data dump,</a> or an incremental approach, such as "just in time" mapping to ROR when organization data is read from or written to your system.</li> </ul> <h2 class="heading heading-2 header-scroll" align=""><div class="heading-anchor anchor waypoint" id="map-other-ids-to-ror-using-the-data-dump"></div><div class="heading-text"><div id="section-map-other-i-ds-to-ror-using-the-data-dump" class="heading-anchor_backwardsCompatibility"></div>Map other IDs to ROR using the data dump</div><a aria-label="Skip link to Map other IDs to ROR using the data dump" class="heading-anchor-icon fa fa-anchor" href="#map-other-ids-to-ror-using-the-data-dump"></a></h2> <p>You can also use the <a target="_self" href="/docs/data-dump">ROR data dump</a> to match other IDs to their equivalent ROR IDs using your own scripts or processing tools. 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="mapping-ringgold-ids-to-ror"></div><div class="heading-text"><div id="section-mapping-ringgold-i-ds-to-ror" class="heading-anchor_backwardsCompatibility"></div>Mapping Ringgold IDs to ROR</div><a aria-label="Skip link to Mapping Ringgold IDs to ROR" class="heading-anchor-icon fa fa-anchor" href="#mapping-ringgold-ids-to-ror"></a></h2> <p>Since Ringgold is a proprietary identifier system, we're currently not able to include Ringgold IDs in ROR records. In the meantime, these approaches are available:</p> <ul> <li><strong>If you have access to the Ringgold Identify database/API</strong>, you can map Ringgold IDs to ROR IDs using ISNI as an intermediary, as ISNI IDs are included in both ROR and Ringgold records.</li> <li><strong>If you do not have access to the Ringgold Identify database/API</strong>, you may be able to map some Ringgold IDs to ROR IDs using Wikidata as an intermediary, as many ROR records contain Wikidata IDs and some Wikidata records contain Ringgold IDs that were derived from the 2019 ORCID public data file and published in <a target="_self" href="http://doi.org/10.5281/zenodo.3241717">http://doi.org/10.5281/zenodo.3241717</a>. See the script at <a target="_self" href="https://github.com/ror-community/ror-utilities/blob/main/general-scripts/map-ringgold-via-wikidata.py">https://github.com/ror-community/ror-utilities/blob/main/general-scripts/map-ringgold-via-wikidata.py</a> for a Python script that performs this matching.</li> </ul> <h2 class="heading heading-2 header-scroll" align=""><div class="heading-anchor anchor waypoint" id="other-external-identifiers"></div><div class="heading-text"><div id="section-other-external-identifiers" class="heading-anchor_backwardsCompatibility"></div>Other external identifiers</div><a aria-label="Skip link to Other external identifiers" class="heading-anchor-icon fa fa-anchor" href="#other-external-identifiers"></a></h2> <p>ROR's current policy is to include only globally unique persistent identifiers as corresponding external IDs in ROR records, which means that national and regional identifiers such as UEI and PIC are not included. If you would benefit from having these or other identifiers in the ROR record, however, you may submit a schema change request on our <a target="_self" href="https://github.com/ror-community/ror-roadmap">roadmap</a> or add a comment to an existing request. </p> <ul> <li><a target="_self" href="https://github.com/ror-community/ror-roadmap/issues/97">Add European Union Participant Identifier Code (PIC)</a> - GitHub roadmap request for EU PIC mapping. Includes a link in the comments to a third-party-generated PIC-to-ROR mapping project that uses CORDIS data. </li> <li><a target="_self" href="https://github.com/ror-community/ror-roadmap/issues/203">Add Unique Entity ID (UEI) tags as external IDs</a> - GitHub roadmap request for UEI mapping. Includes a third-party-generated spreadsheet in the comments that crosswalks over 950 SAM UEI, CAGE codes, DUNS numbers, and GRID IDs.</li> <li><a target="_self" href="https://github.com/opensyllabus/institution-identifiers">US IPEDs mapping file</a> - GitHub repository from the <a target="_self" href="https://www.opensyllabus.org/">OpenSyllabus</a> project with a CSV file that maps ROR IDs for records of type "Education" to GRID, Wikidata, and IPEDs identifiers.</li> <li><a target="_self" href="https://docs.google.com/spreadsheets/d/e/2PACX-1vSWoD7q1vo4j8UC15ok2uC25DfUd87em1fihCMTXeSedK1U_wqn79VO1JqpiLrtI64kGKa3nyVlHxtz/pubhtml">RRID / SciCrunch ID to ROR mapping file</a> - Spreadsheet of mappings between SciCrunch IDs and ROR IDs as of July 2024.</li> </ul></div><div class="UpdatedAt"><p class="DateLine "><i class="icon icon-watch"></i>Updated<!-- --> <!-- -->about 1 month 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"><path stroke="currentColor" stroke-linecap="round" stroke-linejoin="round" d="M5 12h14M12 5l7 7-7 7" 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="#map-other-ids-to-ror-using-the-api">Map other IDs to ROR using the API</a> <ul> <li><a href="#map-a-single-id-to-ror">Map a single ID to ROR</a></li> <li><a href="#map-a-list-of-ids-to-ror">Map a list of IDs to ROR</a></li> <li><a href="#mapping-tips">Mapping tips</a></li> </ul> </li> <li> <a href="#map-other-ids-to-ror-using-the-data-dump">Map other IDs to ROR using the data dump</a> </li> <li> <a href="#mapping-ringgold-ids-to-ror">Mapping Ringgold IDs to ROR</a> </li> <li> <a href="#other-external-identifiers">Other external identifiers</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 data-cfasync="false" src="/cdn-cgi/scripts/5c5dd728/cloudflare-static/email-decode.min.js"></script><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":"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,"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":"","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,"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":"","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":"","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,"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":4,"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,"isBodyEmpty":false,"children":[]},{"_id":"6441b9979730ea1a3d0b0afb","api":{"method":"get","url":"","auth":"required","params":[]},"title":"Schema versions","icon":"","type":"basic","slug":"schema-versions","order":5,"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":6,"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","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,"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","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","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","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","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,"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","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","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":"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":"","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,"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":"","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":"","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":"mapping","rdmd":{"baseUrl":"/","body":"Many ROR records contain equivalent organization IDs of other types in the `external_ids` section. This allows you to find the equivalent ROR ID for several other organization ID types. \n\nOrganization ID types you'll find in ROR records include:\n\n- Crossref Funder ID (formerly FundRef)\n- GRID\n- ISNI\n- Wikidata\n\nNot all records contain all of the ID types above in `external_ids`. In some cases, an equivalent ID may not exist in that identifier type. \n\n> 📘 Migrating from GRID to ROR\n> \n> **GRID published its final public release on 16 Sep 2021** (see [GRID/ROR Transition FAQ](doc:grid)) \n> \n> If you're migrating to ROR from GRID, the good news is that [ROR's JSON data structure](doc:data-structure) is identical to GRID's _and_ every GRID ID has a one-to-one match to a ROR ID!\n> \n> The latest ROR data is available from Zenodo rather than Figshare, however, so if you've been using the Figshare API to import GRID data, you'll need to switch to [downloading the ROR data dump using the Zenodo API](doc:data-dump#download-ror-data-dumps-programmatically-with-the-zenodo-api).\n> \n> You can also find a list of ROR IDs and their equivalent GRID IDs from the Sep 2021 ROR data dump as a CSV file at <https://doi.org/10.5281/zenodo.5534785>\n\n## Map other IDs to ROR using the API\n\n> 📘 \n> \n> This guide provides tips for implementing the ROR API for this specific use case. See the [REST API guide](doc:rest-api) for full information about the ROR API.\n\n### Map a single ID to ROR\n\nSearch for a ROR record containing an equivalent ID of another type in external_ids by using quotes around the ID in a query. \n\nThe query parameter search approach includes the external_ids field and so can be used to search for ROR records that match an external identifier. Use URL-encoded quotation marks before and after the identifier search string for best results.\n\nBecause the query parameter search does not search relationships fields, only the record with the searched-for identifier in the external_ids field will be returned.\n\n```curl\ncurl https://api.ror.org/organizations?query=%22grid.14003.36%22 | json_pp -json_opt pretty,utf8\n```\n\nIf a match is found, the response will contain 1 or more full ROR records. You'll find the corresponding ROR ID(s) in `items[n].id.`\n\n```json\n{\n \"items\" : [\n {\n \"acronyms\" : [\n \"UW\"\n ],\n \"addresses\" : [\n {\n \"city\" : \"Madison\",\n \"country_geonames_id\" : 6252001,\n \"geonames_city\" : {\n \"city\" : \"Madison\",\n \"geonames_admin1\" : {\n \"ascii_name\" : \"Wisconsin\",\n \"code\" : \"US.WI\",\n \"id\" : 5279468,\n \"name\" : \"Wisconsin\"\n },\n \"geonames_admin2\" : {\n \"ascii_name\" : \"Dane\",\n \"code\" : \"US.WI.025\",\n \"id\" : 5250074,\n \"name\" : \"Dane\"\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\" : \"\",\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 ],\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 \"OrgRef\" : {\n \"all\" : [\n \"23536538\",\n \"2429663\",\n \"10260206\"\n ],\n \"preferred\" : \"23536538\"\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\" : \"fr\",\n \"label\" : \"Université du Wisconsin à Madison\"\n },\n {\n \"iso639\" : \"es\",\n \"label\" : \"Universidad de 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/03ydkyb10\",\n \"label\" : \"University of Wisconsin System\",\n \"type\" : \"Parent\"\n },\n {\n \"id\" : \"https://ror.org/05cb4rb43\",\n \"label\" : \"Morgridge Institute for Research\",\n \"type\" : \"Child\"\n },\n {\n \"id\" : \"https://ror.org/03b8vas82\",\n \"label\" : \"National Atmospheric Deposition Program\",\n \"type\" : \"Related\"\n },\n {\n \"id\" : \"https://ror.org/04gq8q482\",\n \"label\" : \"North Temperate Lakes Long Term Ecological Research\",\n \"type\" : \"Child\"\n }\n ],\n \"status\" : \"active\",\n \"types\" : [\n \"Education\"\n ],\n \"wikipedia_url\" : \"http://en.wikipedia.org/wiki/University_of_Wisconsin%E2%80%93Madison\"\n }\n ],\n \"meta\" : {\n \"countries\" : [\n {\n \"count\" : 1,\n \"id\" : \"us\",\n \"title\" : \"United States\"\n }\n ],\n \"statuses\" : [\n {\n \"count\" : 1,\n \"id\" : \"active\",\n \"title\" : \"active\"\n }\n ],\n \"types\" : [\n {\n \"count\" : 1,\n \"id\" : \"education\",\n \"title\" : \"Education\"\n }\n ]\n },\n \"number_of_results\" : 1,\n \"time_taken\" : 7\n}\n```\n\n### Map a list of IDs to ROR\n\nIf you have a list of other IDs you'd like to map to ROR, automate this search with a script. See our [ror-utilities GitHub repository](https://github.com/ror-community/ror-utilities) for an example Python script that accepts a list of other IDs as a CSV file and returns a CSV file with corresponding ROR IDs.\n\n### Mapping tips\n\n- In `external_ids`, each ID type has 2 fields: \"all\" and \"preferred\". For many external IDs, \"preferred\" is null even when \"all\" has only 1 value, so we recommend that you _don't_ limit your mapping to only external IDs designated as preferred.\n- Mapping many thousands of organizations using a script that calls the ROR API can take many hours. If you require a faster approach, you may want to use the [data dump,](doc:data-dump) or an incremental approach, such as \"just in time\" mapping to ROR when organization data is read from or written to your system.\n\n## Map other IDs to ROR using the data dump\n\nYou can also use the [ROR data dump](doc:data-dump) to match other IDs to their equivalent ROR IDs using your own scripts or processing tools. 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## Mapping Ringgold IDs to ROR\n\nSince Ringgold is a proprietary identifier system, we're currently not able to include Ringgold IDs in ROR records. In the meantime, these approaches are available:\n\n- **If you have access to the Ringgold Identify database/API**, you can map Ringgold IDs to ROR IDs using ISNI as an intermediary, as ISNI IDs are included in both ROR and Ringgold records.\n- **If you do not have access to the Ringgold Identify database/API**, you may be able to map some Ringgold IDs to ROR IDs using Wikidata as an intermediary, as many ROR records contain Wikidata IDs and some Wikidata records contain Ringgold IDs that were derived from the 2019 ORCID public data file and published in <http://doi.org/10.5281/zenodo.3241717>. See the script at <https://github.com/ror-community/ror-utilities/blob/main/general-scripts/map-ringgold-via-wikidata.py> for a Python script that performs this matching.\n\n## Other external identifiers\n\nROR's current policy is to include only globally unique persistent identifiers as corresponding external IDs in ROR records, which means that national and regional identifiers such as UEI and PIC are not included. If you would benefit from having these or other identifiers in the ROR record, however, you may submit a schema change request on our [roadmap](https://github.com/ror-community/ror-roadmap) or add a comment to an existing request. \n\n- [Add European Union Participant Identifier Code (PIC)](https://github.com/ror-community/ror-roadmap/issues/97) - GitHub roadmap request for EU PIC mapping. Includes a link in the comments to a third-party-generated PIC-to-ROR mapping project that uses CORDIS data. \n- [Add Unique Entity ID (UEI) tags as external IDs](https://github.com/ror-community/ror-roadmap/issues/203) - GitHub roadmap request for UEI mapping. Includes a third-party-generated spreadsheet in the comments that crosswalks over 950 SAM UEI, CAGE codes, DUNS numbers, and GRID IDs.\n- [US IPEDs mapping file](https://github.com/opensyllabus/institution-identifiers) - GitHub repository from the [OpenSyllabus](https://www.opensyllabus.org/) project with a CSV file that maps ROR IDs for records of type \"Education\" to GRID, Wikidata, and IPEDs identifiers.\n- [RRID / SciCrunch ID to ROR mapping file](https://docs.google.com/spreadsheets/d/e/2PACX-1vSWoD7q1vo4j8UC15ok2uC25DfUd87em1fihCMTXeSedK1U_wqn79VO1JqpiLrtI64kGKa3nyVlHxtz/pubhtml) - Spreadsheet of mappings between SciCrunch IDs and ROR IDs as of July 2024.","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":{},"wrap":false},"safeMode":false,"settings":{"position":true},"theme":"light","resourceID":"60d3e492c16abe006427745b","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,"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=\"#map-other-ids-to-ror-using-the-api\">Map other IDs to ROR using the API</a>\n<ul>\n<li><a href=\"#map-a-single-id-to-ror\">Map a single ID to ROR</a></li>\n<li><a href=\"#map-a-list-of-ids-to-ror\">Map a list of IDs to ROR</a></li>\n<li><a href=\"#mapping-tips\">Mapping tips</a></li>\n</ul>\n</li>\n<li>\n<a href=\"#map-other-ids-to-ror-using-the-data-dump\">Map other IDs to ROR using the data dump</a>\n</li>\n<li>\n<a href=\"#mapping-ringgold-ids-to-ror\">Mapping Ringgold IDs to ROR</a>\n</li>\n<li>\n<a href=\"#other-external-identifiers\">Other external identifiers</a>\n</li>\n</ul></li></ul></nav>","body":"<p>Many ROR records contain equivalent organization IDs of other types in the <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> section. This allows you to find the equivalent ROR ID for several other organization ID types. </p>\n<p>Organization ID types you&#x27;ll find in ROR records include:</p>\n<ul>\n<li>Crossref Funder ID (formerly FundRef)</li>\n<li>GRID</li>\n<li>ISNI</li>\n<li>Wikidata</li>\n</ul>\n<p>Not all records contain all of the ID types above in <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>. In some cases, an equivalent ID may not exist in that identifier type. </p>\n<blockquote class=\"callout callout_info\" theme=\"📘\"><h2 class=\"callout-heading\"><span class=\"callout-icon\">📘</span><p>Migrating from GRID to ROR</p></h2><p><strong>GRID published its final public release on 16 Sep 2021</strong> (see <a href=\"/docs/grid\" target=\"\" title=\"\" class=\"doc-link\" data-sidebar=\"grid\">GRID/ROR Transition FAQ</a>) </p><p>If you&#x27;re migrating to ROR from GRID, the good news is that <a href=\"/docs/data-structure\" target=\"\" title=\"\" class=\"doc-link\" data-sidebar=\"data-structure\">ROR&#x27;s JSON data structure</a> is identical to GRID&#x27;s <em>and</em> every GRID ID has a one-to-one match to a ROR ID!</p><p>The latest ROR data is available from Zenodo rather than Figshare, however, so if you&#x27;ve been using the Figshare API to import GRID data, you&#x27;ll need to switch to <a href=\"/docs/data-dump#download-ror-data-dumps-programmatically-with-the-zenodo-api\" target=\"\" title=\"\" class=\"doc-link\" data-sidebar=\"data-dump#download-ror-data-dumps-programmatically-with-the-zenodo-api\">downloading the ROR data dump using the Zenodo API</a>.</p><p>You can also find a list of ROR IDs and their equivalent GRID IDs from the Sep 2021 ROR data dump as a CSV file at <a href=\"https://doi.org/10.5281/zenodo.5534785\" target=\"\" title=\"\">https://doi.org/10.5281/zenodo.5534785</a></p></blockquote>\n<h2 class=\"heading heading-2 header-scroll\" align=\"\"><div class=\"heading-anchor anchor waypoint\" id=\"map-other-ids-to-ror-using-the-api\"></div><div class=\"heading-text\"><div id=\"section-map-other-i-ds-to-ror-using-the-api\" class=\"heading-anchor_backwardsCompatibility\"></div>Map other IDs to ROR using the API</div><a aria-label=\"Skip link to Map other IDs to ROR using the API\" class=\"heading-anchor-icon fa fa-anchor\" href=\"#map-other-ids-to-ror-using-the-api\"></a></h2>\n<blockquote class=\"callout callout_info\" theme=\"📘\"><h2 class=\"callout-heading empty\"><span class=\"callout-icon\">📘</span></h2><p>This guide provides tips for implementing the ROR API for this specific use case. See the <a href=\"/docs/rest-api\" target=\"\" title=\"\" class=\"doc-link\" data-sidebar=\"rest-api\">REST API guide</a> for full information about the ROR API.</p></blockquote>\n<h3 class=\"heading heading-3 header-scroll\" align=\"\"><div class=\"heading-anchor anchor waypoint\" id=\"map-a-single-id-to-ror\"></div><div class=\"heading-text\"><div id=\"section-map-a-single-id-to-ror\" class=\"heading-anchor_backwardsCompatibility\"></div>Map a single ID to ROR</div><a aria-label=\"Skip link to Map a single ID to ROR\" class=\"heading-anchor-icon fa fa-anchor\" href=\"#map-a-single-id-to-ror\"></a></h3>\n<p>Search for a ROR record containing an equivalent ID of another type in external_ids by using quotes around the ID in a query. </p>\n<p>The query parameter search approach includes the external_ids field and so can be used to search for ROR records that match an external identifier. Use URL-encoded quotation marks before and after the identifier search string for best results.</p>\n<p>Because the query parameter search does not search relationships fields, only the record with the searched-for identifier in the external_ids field will be returned.</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 https://api.ror.org/organizations?query=%22grid.14003.36%22 | json_pp -json_opt pretty,utf8\n</code></pre></div></div>\n<p>If a match is found, the response will contain 1 or more full ROR records. You&#x27;ll find the corresponding ROR ID(s) in <button aria-label=\"Copy Code\" class=\"rdmd-code-copy fa\"></button><code class=\"rdmd-code lang- theme-light\" data-lang=\"\" name=\"\" tabindex=\"0\">items[n].id.</code></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;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; : 6252001,\n &quot;geonames_city&quot; : {\n &quot;city&quot; : &quot;Madison&quot;,\n &quot;geonames_admin1&quot; : {\n &quot;ascii_name&quot; : &quot;Wisconsin&quot;,\n &quot;code&quot; : &quot;US.WI&quot;,\n &quot;id&quot; : 5279468,\n &quot;name&quot; : &quot;Wisconsin&quot;\n },\n &quot;geonames_admin2&quot; : {\n &quot;ascii_name&quot; : &quot;Dane&quot;,\n &quot;code&quot; : &quot;US.WI.025&quot;,\n &quot;id&quot; : 5250074,\n &quot;name&quot; : &quot;Dane&quot;\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; : &quot;&quot;,\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 ],\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;OrgRef&quot; : {\n &quot;all&quot; : [\n &quot;23536538&quot;,\n &quot;2429663&quot;,\n &quot;10260206&quot;\n ],\n &quot;preferred&quot; : &quot;23536538&quot;\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;fr&quot;,\n &quot;label&quot; : &quot;Université du Wisconsin à Madison&quot;\n },\n {\n &quot;iso639&quot; : &quot;es&quot;,\n &quot;label&quot; : &quot;Universidad de 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/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/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/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/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;status&quot; : &quot;active&quot;,\n &quot;types&quot; : [\n &quot;Education&quot;\n ],\n &quot;wikipedia_url&quot; : &quot;http://en.wikipedia.org/wiki/University_of_Wisconsin%E2%80%93Madison&quot;\n }\n ],\n &quot;meta&quot; : {\n &quot;countries&quot; : [\n {\n &quot;count&quot; : 1,\n &quot;id&quot; : &quot;us&quot;,\n &quot;title&quot; : &quot;United States&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;education&quot;,\n &quot;title&quot; : &quot;Education&quot;\n }\n ]\n },\n &quot;number_of_results&quot; : 1,\n &quot;time_taken&quot; : 7\n}\n</code></pre></div></div>\n<h3 class=\"heading heading-3 header-scroll\" align=\"\"><div class=\"heading-anchor anchor waypoint\" id=\"map-a-list-of-ids-to-ror\"></div><div class=\"heading-text\"><div id=\"section-map-a-list-of-i-ds-to-ror\" class=\"heading-anchor_backwardsCompatibility\"></div>Map a list of IDs to ROR</div><a aria-label=\"Skip link to Map a list of IDs to ROR\" class=\"heading-anchor-icon fa fa-anchor\" href=\"#map-a-list-of-ids-to-ror\"></a></h3>\n<p>If you have a list of other IDs you&#x27;d like to map to ROR, automate this search with a script. See our <a href=\"https://github.com/ror-community/ror-utilities\" target=\"\" title=\"\">ror-utilities GitHub repository</a> for an example Python script that accepts a list of other IDs as a CSV file and returns a CSV file with corresponding ROR IDs.</p>\n<h3 class=\"heading heading-3 header-scroll\" align=\"\"><div class=\"heading-anchor anchor waypoint\" id=\"mapping-tips\"></div><div class=\"heading-text\"><div id=\"section-mapping-tips\" class=\"heading-anchor_backwardsCompatibility\"></div>Mapping tips</div><a aria-label=\"Skip link to Mapping tips\" class=\"heading-anchor-icon fa fa-anchor\" href=\"#mapping-tips\"></a></h3>\n<ul>\n<li>In <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>, each ID type has 2 fields: &quot;all&quot; and &quot;preferred&quot;. For many external IDs, &quot;preferred&quot; is null even when &quot;all&quot; has only 1 value, so we recommend that you <em>don&#x27;t</em> limit your mapping to only external IDs designated as preferred.</li>\n<li>Mapping many thousands of organizations using a script that calls the ROR API can take many hours. If you require a faster approach, you may want to use the <a href=\"/docs/data-dump\" target=\"\" title=\"\" class=\"doc-link\" data-sidebar=\"data-dump\">data dump,</a> or an incremental approach, such as &quot;just in time&quot; mapping to ROR when organization data is read from or written to your system.</li>\n</ul>\n<h2 class=\"heading heading-2 header-scroll\" align=\"\"><div class=\"heading-anchor anchor waypoint\" id=\"map-other-ids-to-ror-using-the-data-dump\"></div><div class=\"heading-text\"><div id=\"section-map-other-i-ds-to-ror-using-the-data-dump\" class=\"heading-anchor_backwardsCompatibility\"></div>Map other IDs to ROR using the data dump</div><a aria-label=\"Skip link to Map other IDs to ROR using the data dump\" class=\"heading-anchor-icon fa fa-anchor\" href=\"#map-other-ids-to-ror-using-the-data-dump\"></a></h2>\n<p>You can also use the <a href=\"/docs/data-dump\" target=\"\" title=\"\" class=\"doc-link\" data-sidebar=\"data-dump\">ROR data dump</a> to match other IDs to their equivalent ROR IDs using your own scripts or processing tools. 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=\"mapping-ringgold-ids-to-ror\"></div><div class=\"heading-text\"><div id=\"section-mapping-ringgold-i-ds-to-ror\" class=\"heading-anchor_backwardsCompatibility\"></div>Mapping Ringgold IDs to ROR</div><a aria-label=\"Skip link to Mapping Ringgold IDs to ROR\" class=\"heading-anchor-icon fa fa-anchor\" href=\"#mapping-ringgold-ids-to-ror\"></a></h2>\n<p>Since Ringgold is a proprietary identifier system, we&#x27;re currently not able to include Ringgold IDs in ROR records. In the meantime, these approaches are available:</p>\n<ul>\n<li><strong>If you have access to the Ringgold Identify database/API</strong>, you can map Ringgold IDs to ROR IDs using ISNI as an intermediary, as ISNI IDs are included in both ROR and Ringgold records.</li>\n<li><strong>If you do not have access to the Ringgold Identify database/API</strong>, you may be able to map some Ringgold IDs to ROR IDs using Wikidata as an intermediary, as many ROR records contain Wikidata IDs and some Wikidata records contain Ringgold IDs that were derived from the 2019 ORCID public data file and published in <a href=\"http://doi.org/10.5281/zenodo.3241717\" target=\"\" title=\"\">http://doi.org/10.5281/zenodo.3241717</a>. See the script at <a href=\"https://github.com/ror-community/ror-utilities/blob/main/general-scripts/map-ringgold-via-wikidata.py\" target=\"\" title=\"\">https://github.com/ror-community/ror-utilities/blob/main/general-scripts/map-ringgold-via-wikidata.py</a> for a Python script that performs this matching.</li>\n</ul>\n<h2 class=\"heading heading-2 header-scroll\" align=\"\"><div class=\"heading-anchor anchor waypoint\" id=\"other-external-identifiers\"></div><div class=\"heading-text\"><div id=\"section-other-external-identifiers\" class=\"heading-anchor_backwardsCompatibility\"></div>Other external identifiers</div><a aria-label=\"Skip link to Other external identifiers\" class=\"heading-anchor-icon fa fa-anchor\" href=\"#other-external-identifiers\"></a></h2>\n<p>ROR&#x27;s current policy is to include only globally unique persistent identifiers as corresponding external IDs in ROR records, which means that national and regional identifiers such as UEI and PIC are not included. If you would benefit from having these or other identifiers in the ROR record, however, you may submit a schema change request on our <a href=\"https://github.com/ror-community/ror-roadmap\" target=\"\" title=\"\">roadmap</a> or add a comment to an existing request. </p>\n<ul>\n<li><a href=\"https://github.com/ror-community/ror-roadmap/issues/97\" target=\"\" title=\"\">Add European Union Participant Identifier Code (PIC)</a> - GitHub roadmap request for EU PIC mapping. Includes a link in the comments to a third-party-generated PIC-to-ROR mapping project that uses CORDIS data. </li>\n<li><a href=\"https://github.com/ror-community/ror-roadmap/issues/203\" target=\"\" title=\"\">Add Unique Entity ID (UEI) tags as external IDs</a> - GitHub roadmap request for UEI mapping. Includes a third-party-generated spreadsheet in the comments that crosswalks over 950 SAM UEI, CAGE codes, DUNS numbers, and GRID IDs.</li>\n<li><a href=\"https://github.com/opensyllabus/institution-identifiers\" target=\"\" title=\"\">US IPEDs mapping file</a> - GitHub repository from the <a href=\"https://www.opensyllabus.org/\" target=\"\" title=\"\">OpenSyllabus</a> project with a CSV file that maps ROR IDs for records of type &quot;Education&quot; to GRID, Wikidata, and IPEDs identifiers.</li>\n<li><a href=\"https://docs.google.com/spreadsheets/d/e/2PACX-1vSWoD7q1vo4j8UC15ok2uC25DfUd87em1fihCMTXeSedK1U_wqn79VO1JqpiLrtI64kGKa3nyVlHxtz/pubhtml\" target=\"\" title=\"\">RRID / SciCrunch ID to ROR mapping file</a> - Spreadsheet of mappings between SciCrunch IDs and ROR IDs as of July 2024.</li>\n</ul>"}},"doc":{"metadata":{"image":[],"title":"","description":"This document explains how to map other organization IDs to ROR IDs using the ROR API or data dump, including tips for implementation and specific use cases like migrating from GRID to ROR.","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":[],"examples":{"codes":[]}},"next":{"description":"","pages":[{"type":"doc","icon":"file-text-o","name":"OpenRefine reconciler","slug":"openrefine-reconciler","category":"Tools & services"}]},"algolia":{"recordCount":8,"publishPending":false,"translationFailure":false,"updatedAt":"2024-10-16T19:32:47.221Z"},"title":"Map other organization IDs to ROR IDs","icon":"","updates":[],"type":"basic","slug":"mapping","excerpt":"","body":"Many ROR records contain equivalent organization IDs of other types in the `external_ids` section. This allows you to find the equivalent ROR ID for several other organization ID types. \n\nOrganization ID types you'll find in ROR records include:\n\n- Crossref Funder ID (formerly FundRef)\n- GRID\n- ISNI\n- Wikidata\n\nNot all records contain all of the ID types above in `external_ids`. In some cases, an equivalent ID may not exist in that identifier type. \n\n> 📘 Migrating from GRID to ROR\n> \n> **GRID published its final public release on 16 Sep 2021** (see [GRID/ROR Transition FAQ](doc:grid)) \n> \n> If you're migrating to ROR from GRID, the good news is that [ROR's JSON data structure](doc:data-structure) is identical to GRID's _and_ every GRID ID has a one-to-one match to a ROR ID!\n> \n> The latest ROR data is available from Zenodo rather than Figshare, however, so if you've been using the Figshare API to import GRID data, you'll need to switch to [downloading the ROR data dump using the Zenodo API](doc:data-dump#download-ror-data-dumps-programmatically-with-the-zenodo-api).\n> \n> You can also find a list of ROR IDs and their equivalent GRID IDs from the Sep 2021 ROR data dump as a CSV file at <https://doi.org/10.5281/zenodo.5534785>\n\n## Map other IDs to ROR using the API\n\n> 📘 \n> \n> This guide provides tips for implementing the ROR API for this specific use case. See the [REST API guide](doc:rest-api) for full information about the ROR API.\n\n### Map a single ID to ROR\n\nSearch for a ROR record containing an equivalent ID of another type in external_ids by using quotes around the ID in a query. \n\nThe query parameter search approach includes the external_ids field and so can be used to search for ROR records that match an external identifier. Use URL-encoded quotation marks before and after the identifier search string for best results.\n\nBecause the query parameter search does not search relationships fields, only the record with the searched-for identifier in the external_ids field will be returned.\n\n```curl\ncurl https://api.ror.org/organizations?query=%22grid.14003.36%22 | json_pp -json_opt pretty,utf8\n```\n\nIf a match is found, the response will contain 1 or more full ROR records. You'll find the corresponding ROR ID(s) in `items[n].id.`\n\n```json\n{\n \"items\" : [\n {\n \"acronyms\" : [\n \"UW\"\n ],\n \"addresses\" : [\n {\n \"city\" : \"Madison\",\n \"country_geonames_id\" : 6252001,\n \"geonames_city\" : {\n \"city\" : \"Madison\",\n \"geonames_admin1\" : {\n \"ascii_name\" : \"Wisconsin\",\n \"code\" : \"US.WI\",\n \"id\" : 5279468,\n \"name\" : \"Wisconsin\"\n },\n \"geonames_admin2\" : {\n \"ascii_name\" : \"Dane\",\n \"code\" : \"US.WI.025\",\n \"id\" : 5250074,\n \"name\" : \"Dane\"\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\" : \"\",\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 ],\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 \"OrgRef\" : {\n \"all\" : [\n \"23536538\",\n \"2429663\",\n \"10260206\"\n ],\n \"preferred\" : \"23536538\"\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\" : \"fr\",\n \"label\" : \"Université du Wisconsin à Madison\"\n },\n {\n \"iso639\" : \"es\",\n \"label\" : \"Universidad de 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/03ydkyb10\",\n \"label\" : \"University of Wisconsin System\",\n \"type\" : \"Parent\"\n },\n {\n \"id\" : \"https://ror.org/05cb4rb43\",\n \"label\" : \"Morgridge Institute for Research\",\n \"type\" : \"Child\"\n },\n {\n \"id\" : \"https://ror.org/03b8vas82\",\n \"label\" : \"National Atmospheric Deposition Program\",\n \"type\" : \"Related\"\n },\n {\n \"id\" : \"https://ror.org/04gq8q482\",\n \"label\" : \"North Temperate Lakes Long Term Ecological Research\",\n \"type\" : \"Child\"\n }\n ],\n \"status\" : \"active\",\n \"types\" : [\n \"Education\"\n ],\n \"wikipedia_url\" : \"http://en.wikipedia.org/wiki/University_of_Wisconsin%E2%80%93Madison\"\n }\n ],\n \"meta\" : {\n \"countries\" : [\n {\n \"count\" : 1,\n \"id\" : \"us\",\n \"title\" : \"United States\"\n }\n ],\n \"statuses\" : [\n {\n \"count\" : 1,\n \"id\" : \"active\",\n \"title\" : \"active\"\n }\n ],\n \"types\" : [\n {\n \"count\" : 1,\n \"id\" : \"education\",\n \"title\" : \"Education\"\n }\n ]\n },\n \"number_of_results\" : 1,\n \"time_taken\" : 7\n}\n```\n\n### Map a list of IDs to ROR\n\nIf you have a list of other IDs you'd like to map to ROR, automate this search with a script. See our [ror-utilities GitHub repository](https://github.com/ror-community/ror-utilities) for an example Python script that accepts a list of other IDs as a CSV file and returns a CSV file with corresponding ROR IDs.\n\n### Mapping tips\n\n- In `external_ids`, each ID type has 2 fields: \"all\" and \"preferred\". For many external IDs, \"preferred\" is null even when \"all\" has only 1 value, so we recommend that you _don't_ limit your mapping to only external IDs designated as preferred.\n- Mapping many thousands of organizations using a script that calls the ROR API can take many hours. If you require a faster approach, you may want to use the [data dump,](doc:data-dump) or an incremental approach, such as \"just in time\" mapping to ROR when organization data is read from or written to your system.\n\n## Map other IDs to ROR using the data dump\n\nYou can also use the [ROR data dump](doc:data-dump) to match other IDs to their equivalent ROR IDs using your own scripts or processing tools. 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## Mapping Ringgold IDs to ROR\n\nSince Ringgold is a proprietary identifier system, we're currently not able to include Ringgold IDs in ROR records. In the meantime, these approaches are available:\n\n- **If you have access to the Ringgold Identify database/API**, you can map Ringgold IDs to ROR IDs using ISNI as an intermediary, as ISNI IDs are included in both ROR and Ringgold records.\n- **If you do not have access to the Ringgold Identify database/API**, you may be able to map some Ringgold IDs to ROR IDs using Wikidata as an intermediary, as many ROR records contain Wikidata IDs and some Wikidata records contain Ringgold IDs that were derived from the 2019 ORCID public data file and published in <http://doi.org/10.5281/zenodo.3241717>. See the script at <https://github.com/ror-community/ror-utilities/blob/main/general-scripts/map-ringgold-via-wikidata.py> for a Python script that performs this matching.\n\n## Other external identifiers\n\nROR's current policy is to include only globally unique persistent identifiers as corresponding external IDs in ROR records, which means that national and regional identifiers such as UEI and PIC are not included. If you would benefit from having these or other identifiers in the ROR record, however, you may submit a schema change request on our [roadmap](https://github.com/ror-community/ror-roadmap) or add a comment to an existing request. \n\n- [Add European Union Participant Identifier Code (PIC)](https://github.com/ror-community/ror-roadmap/issues/97) - GitHub roadmap request for EU PIC mapping. Includes a link in the comments to a third-party-generated PIC-to-ROR mapping project that uses CORDIS data. \n- [Add Unique Entity ID (UEI) tags as external IDs](https://github.com/ror-community/ror-roadmap/issues/203) - GitHub roadmap request for UEI mapping. Includes a third-party-generated spreadsheet in the comments that crosswalks over 950 SAM UEI, CAGE codes, DUNS numbers, and GRID IDs.\n- [US IPEDs mapping file](https://github.com/opensyllabus/institution-identifiers) - GitHub repository from the [OpenSyllabus](https://www.opensyllabus.org/) project with a CSV file that maps ROR IDs for records of type \"Education\" to GRID, Wikidata, and IPEDs identifiers.\n- [RRID / SciCrunch ID to ROR mapping file](https://docs.google.com/spreadsheets/d/e/2PACX-1vSWoD7q1vo4j8UC15ok2uC25DfUd87em1fihCMTXeSedK1U_wqn79VO1JqpiLrtI64kGKa3nyVlHxtz/pubhtml) - Spreadsheet of mappings between SciCrunch IDs and ROR IDs as of July 2024.","order":2,"isReference":false,"deprecated":false,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"reusableContent":[],"previousSlug":"map-other-organization-id-types-to-ror","slugUpdatedAt":"2024-03-09T19:25:49.201Z","revision":36,"_id":"60d3e492c16abe006427745b","pendingAlgoliaPublish":false,"createdAt":"2021-06-24T01:49:06.244Z","updatedAt":"2024-10-16T19:32:47.228Z","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":3,"parentDoc":null,"lastUpdatedHash":"cf9fc741b13a271201ccff538d67dcc7955ac261","isApi":false,"tutorials":[],"id":"60d3e492c16abe006427745b"},"hideTOC":false,"meta":{"_id":"60d3e492c16abe006427745b","description":"This document explains how to map other organization IDs to ROR IDs using the ROR API or data dump, including tips for implementation and specific use cases like migrating from GRID to ROR.","hidden":false,"image":[],"keywords":"","metaTitle":"Map other organization IDs to ROR IDs","parent":null,"robots":"index","slug":"mapping","title":"Map other organization IDs to ROR IDs","type":"docs"},"slugUrl":"/docs/mapping","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.235.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/4330c08-small-ror-logo-large.png","4330c08-small-ror-logo-large.png",125,80,"#000000","https://files.readme.io/e784d79-ror-logo-large.png","64c16bb48938310012444a6e"],"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,"superHubMigrationSelfServeFlow":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,"hasOneChild":false,"healthCheck":{"provider":"","settings":{}},"intercom_secure_emailonly":false,"intercom":"","is_active":true,"internal":"","jwtExpirationTime":0,"landing_bottom":[{"type":"text","alignment":"left","title":"ROR v1 will be deprecated in 2025","text":"Have you switched yet to v2 of the ROR schema and API? Remember that v1 of ROR will be deprecated in 2025. Read more about [version 2 in the changelog](https://ror.readme.io/v2/changelog/2024-04-11-schema-api-v2) and flip the toggle to switch between documentation for v1 and v2."},{"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/mapping"}],"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.","parent":null,"homepage_url":"https://ror.org","id":"6058e47681775f002de04832","is_migrated":false,"name":"ROR","redirects":[],"sitemap":"disabled","subdomain":"ror","suggested_edits":"enabled","uri":"/projects/me","variable_defaults":[],"webhooks":[],"custom_login":{"login_url":null,"logout_url":null},"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},"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":{"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":"65ef46717fce1c0036177477"}},"main":{"uri":"/images/64c16bb48938310012444a6e","url":"https://files.readme.io/4330c08-small-ror-logo-large.png","name":"4330c08-small-ror-logo-large.png","width":125,"height":80,"color":"#000000","links":{"original_url":"https://files.readme.io/e784d79-ror-logo-large.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/mapping","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">[6859,1802,9772,3284,7449,7372,9082,572,5312,5548,2395,6522,7112,4608,8263,1282,2852,3880,7783,1456,4935,6841,6722,1936,5798,4002,3787,7971,153,1313,1343,1666,6922,2859,1202,1080,9852,8684,9575,6060,2578,3859,8063,3221,7327,7285,3307,2144,9141,1948,5408,2637,4674,1731,2616,3412,2402]</script><script id="__LOADABLE_REQUIRED_CHUNKS___ext" type="application/json">{"namedChunks":["routes-SuperHub","Header","core-icons-chevron-up-down-svg","routes-Doc","Footer","routes-Landing","routes-Reference","core-icons-more-vertical-svg","routes-PageNotFound","CustomPage","core-icons-alert-circle-svg","routes-CustomPage","Editor","core-icons-x-circle-svg","core-icons-suggested-edits-svg","core-icons-arrow-right-svg","core-icons-lock-svg","core-icons-eye-off-svg","core-icons-chevron-down-svg","core-icons-arrow-up-right-svg","core-icons-search-svg","core-icons-custom-pages-svg","routes-SuperHub-Routes","routes-Changelog","Post","rmdx","routes-Discuss","List","core-icons-trending-up-svg","core-icons-callout-info-svg","Page"]}</script> <script async data-chunk="main" src="https://cdn.readme.io/public/hub/web/main.766cf20fa350c2c18107.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/6859.fc1496da022e612abe33.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/1802.00a1e88cc0d9da2aae1b.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/9772.1912e092b9c8785ff5c3.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/3284.6ecd6ef27e2009d3fdc7.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/572.bab1eda8453360a8a761.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/5312.ca2c08ec1b75bb03c21e.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/5548.8fb1bb5d57de6c263c67.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/2395.6288c030d5183baa5a89.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/6522.057d8ea587133ae98687.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/7112.69c3d611e7e54e411b26.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/4608.3b5a227647e78e858c3f.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/8263.a563779273b90f66c0db.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/1282.591f476c316bf3670bbd.js"></script> <script async data-chunk="routes-SuperHub" src="https://cdn.readme.io/public/hub/web/routes-SuperHub.a3bb3020bf29f8f67ef8.js"></script> <script async data-chunk="Header" src="https://cdn.readme.io/public/hub/web/3880.3892311d81c548cb073c.js"></script> <script async data-chunk="Header" src="https://cdn.readme.io/public/hub/web/7783.48ca7ef3a5c469d97e53.js"></script> <script async data-chunk="Header" src="https://cdn.readme.io/public/hub/web/Header.ad57d9fcd570c04fb712.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-Doc" src="https://cdn.readme.io/public/hub/web/6841.587d285d41ca8bab11b1.js"></script> <script async data-chunk="routes-Doc" src="https://cdn.readme.io/public/hub/web/6722.e485c5aa155bd0f0ccf8.js"></script> <script async data-chunk="routes-Doc" src="https://cdn.readme.io/public/hub/web/routes-Doc.e3a4e0817a9a640436bc.js"></script> <script async data-chunk="Footer" src="https://cdn.readme.io/public/hub/web/Footer.eb98b86c4279989f5a59.js"></script> <script async data-chunk="routes-Landing" src="https://cdn.readme.io/public/hub/web/4002.08d1caef58d08eaccd19.js"></script> <script async data-chunk="routes-Landing" src="https://cdn.readme.io/public/hub/web/routes-Landing.f0816876bdfbbc06801a.js"></script> <script async data-chunk="routes-Reference" src="https://cdn.readme.io/public/hub/web/7971.db270c2970b791e38435.js"></script> <script async data-chunk="routes-Reference" src="https://cdn.readme.io/public/hub/web/153.e4db5a313c7d51383015.js"></script> <script async data-chunk="routes-Reference" src="https://cdn.readme.io/public/hub/web/routes-Reference.d66a49f09580aafdabb6.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="routes-PageNotFound" src="https://cdn.readme.io/public/hub/web/routes-PageNotFound.84a460336ee9c83a7d55.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/2859.94b03b9a9585460aa921.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="Editor" src="https://cdn.readme.io/public/hub/web/Editor.002979730c36f9c65ad3.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-arrow-right-svg" src="https://cdn.readme.io/public/hub/web/core-icons-arrow-right-svg.eadb74658f93b4e7d75f.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="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-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-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-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.5ccfbee71da134a1eeba.js"></script> <script async data-chunk="routes-Changelog" src="https://cdn.readme.io/public/hub/web/routes-Changelog.3f125a62ed05cc53aec4.js"></script> <script async data-chunk="Post" src="https://cdn.readme.io/public/hub/web/Post.cced33af5051de7f473f.js"></script> <script async data-chunk="rmdx" src="https://cdn.readme.io/public/hub/web/rmdx.594ae0fac8012b876a80.js"></script> <script async data-chunk="routes-Discuss" src="https://cdn.readme.io/public/hub/web/routes-Discuss.6a5b69949f194448cf4f.js"></script> <script async data-chunk="List" src="https://cdn.readme.io/public/hub/web/2637.a5df1d5e240762d7981f.js"></script> <script async data-chunk="List" src="https://cdn.readme.io/public/hub/web/4674.13378da16ce7b5beba66.js"></script> <script async data-chunk="List" src="https://cdn.readme.io/public/hub/web/List.12cee315afa198c8e23e.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="Page" src="https://cdn.readme.io/public/hub/web/Page.65c6f721688901333944.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>