Finding ORCID record holders at your institution

Search for records via the API

The ORCID Registry is designed to have users provide their iDs to organizations using OAuth, which ensures that the correct iD is collected for each researcher. We discourage organizations from adding ORCID iDs to their systems based on a search for researchers by name. However, it can be helpful to find out how many researchers at your organization have ORCID iDs, which can be done via the API. Suggestions for searching by organization are given below.

For an introduction to searching, how to get an access token using two-legged authorization, how to understand your search results, and details of other fields that can be searched, see Searching with the API.

 

Search by email domain

You can use the API to search for researchers by email domain. Keep in mind that by default email addresses in ORCID are private and any records with a private email address will not be returned in this search.

An example call to search for all records with an @orcid.org email address:

  Method: GET
  Content-type: application/vnd.orcid+xml
  Authorization type: Bearer
  Access token: [Stored access token]
  URL:  https://pub.orcid.org/v2.0/search/?q=email:*@orcid.org

 

Search by name and DOI

When checking to see if an individual has an ORCID record, we recommend searching by both their name and the DOI of one or more of their recent works. This should result in just the record of the researcher you are looking for, and not records of anyone else who shares the same name.

An example call to search for all records with the name Laurel Haak and either the DOI 10.1087/20120404 or the DOI 10.6084/M9.FIGSHARE.1115124: 

  Method: GET
  Content-type: application/vnd.orcid+xml
  Authorization type: Bearer
  Access token: [Stored access token]
  URL:  https://pub.orcid.org/v2.0/search?q=family-name:Haak+AND+given-names:Laurel+AND+digital-object-ids:%2210.1087/20120404%22+OR+digital-object-ids:%2210.6084/M9.FIGSHARE.1115124’%22

 

Search by affiliation

The affiliation fields are not separately indexed in the ORCID Registry, but they can be searched as part of a keyword search of the entire record. You can look for records which list your organization based on its Ringgold ID. We also recommend including your organization"s name as a keyword to reduce matches on the Ringgold ID string in other fields. (You can find your organization"s Ringgold ID in the Ringgold Identify Database.)

An example call to search for all records with the ORCID Ringgold ID (385488) and the word ORCID:

  Method: GET
  Content-type: application/vnd.orcid+xml
  Authorization type: Bearer
  Access token: [Stored access token]
  URL:  https://pub.orcid.org/v2.0/search?q=385488+AND+ORCID

 

Wait, we only get 100 results! 

When you first query the API, the API will return the number of search results found in <orcid-search-results num-found="XXX">, as below: 

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<search:search num-found="3059308" xmlns:search="http://www.orcid.org/ns/search" xmlns:common="http://www.orcid.org/ns/common">

By default, the API returns the first 100 search results ("rows"). You can add additional parameters to specify the number of results returned, as well as the starting point. The maximum number of results that can be returned in any one query is 200. 

An example call to return the first 200 results (1-200) for all records with the ORCID Ringgold ID (385488) and the word ORCID:

  Method: GET
  Content-type: application/vnd.orcid+xml
  Authorization type: Bearer
  Access token: [Stored access token]
  URL: https://pub.orcid.org/v2.0/search?q=385488+AND+ORCID&start=1&rows=200

An example call to return the second 200 results (201-400) for all records with the ORCID Ringgold ID (385488) and the word ORCID:

  Method: GET
  Content-type: application/vnd.orcid+xml
  Authorization type: Bearer
  Access token: [Stored access token]
  URL: https://pub.orcid.org/v2.0/search?q=385488+AND+ORCID&start=201&rows=200

 

Request statistics by email domain

In addition to the search options above, ORCID staff can check the total number of ORCID records registered to your organization’s email domain. Note that these requests will only return the total number of records with a given email domain, not the individual ORCID iDs due to our privacy policy. ORCID does not guarantee the continual availability of this service.

 







Please note that request for statistics must be run individually by the ORCID team so there may be a delay of a couple days before we get back to you.