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, and details of other fields that can be search see Searching with the API.

Search by email domain

You can use the API to search for researchers by email domain. But 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.

 

 

Search by email domain

Description Search for all records with an @orcid.org email address
Example call to get an access token curl -i -L -H "Accept: application/json" -d "client_id=APP-PHTDAE3CX23FH7FD" -d "client_secret=5160c539-4ec9-4e8c-8966-580df68b494f" -d "scope=/read-public" -d "grant_type=client_credentials" "https://orcid.org/oauth/token"
Example URL curl -H "Content-Type: application/orcid+xml" -H "Authorization: Bearer aa2c8730-07af-4ac6-fb22c0987348" "https://pub.orcid.org/v1.2/search/orcid-bio/?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.

 

 

Search by name and DOI

Description Search for all records with the name Laurel Haak and the DOI 10.1087/20120404
Example call to get an access token curl -i -L -H "Accept: application/json" -d "client_id=APP-PHTDAE3CX23FH7FD" -d "client_secret=9260d530-8ef9-9e8c-8967-580df68b232d" -d "scope=/read-public" -d "grant_type=client_credentials" "https://orcid.org/oauth/token"
Example URL curl -H "Content-Type: application/orcid+xml" -H "Authorization: Bearer 27196816-2a3c-42fa-9b83-9bf9115cb8b7" "https://pub.orcid.org/v1.2/search/orcid-bio/?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.)

 

 

Search by Ringgold ID

Description Search for all records with the ORCID Ringgold ID (385488) and the word ORCID
Example call to get an access token curl -i -L -H "Accept: application/json" -d "client_id=APP-PHTDAE3CX23FH7FD" -d "client_secret=9260d530-8ef9-9e8c-8967-580df68b232d" -d "scope=/read-public" -d "grant_type=client_credentials" "https://orcid.org/oauth/token"
Example URL curl -H "Content-Type: application/orcid+xml" -H "Authorization: Bearer 27196816-2a3c-42fa-9b83-9bf9115cb8b7" "https://pub.orcid.org/v1.2/search/orcid-bio/?q=385488+AND+ORCID"

 

Wait, we only get 10 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"?>
<orcid-message xmlns="http://www.orcid.org/ns/orcid">
    <message-version>1.2</message-version>
    <orcid-search-results num-found="636">

By default, the API returns the first ten 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 100. This series of requests will return first results 1-100, and then 101-200: 

Results 1-100

curl -H "Content-Type: application/orcid+xml" -H "Authorization: Bearer 27196816-2a3c-42fa-9b83-9bf9115cb8b7" "https://pub.orcid.org/v1.2/search/orcid-bio/?q=385488+AND+ORCID&start=1&rows=100"

Results 101-200

curl -H "Content-Type: application/orcid+xml" -H "Authorization: Bearer 27196816-2a3c-42fa-9b83-9bf9115cb8b7" "https://pub.orcid.org/v1.2/search/orcid-bio/?q=385488+AND+ORCID&start=101&rows=100"

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.