{"openapi":"3.1.0","info":{"title":"ORCID API","version":"1.0.0","description":"ORCID as an API — the global researcher identity registry, powered by the ORCID Public API. An ORCID iD (for example 0000-0002-1825-0097) uniquely and persistently identifies a researcher across journals, funders, universities and the entire scholarly record. Search more than 15 million researchers by name, institution, keyword or external identifier using rich Solr field syntax, getting each match's ORCID iD, name, other names and affiliated institutions; read a researcher's public profile including their published and credit names, biography, research keywords, country, personal and lab websites and external identifiers such as Scopus Author ID or ResearcherID; list the works they have claimed on their record with each work's title, type, publication year, journal and DOI; and trace their employment and education affiliations with the organization, role, department and dates. Ideal for research-information systems, author disambiguation, institutional reporting, scholarly tooling and academic search. ORCID iDs come from search results or are supplied directly by the researcher. Data is the public portion of ORCID records (CC0). For the scholarly works and citation graph see the OpenAlex API; for DOIs and journal metadata the Crossref API.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/orcid-api","description":"oanor gateway"}],"tags":[{"name":"Researchers"},{"name":"Works"},{"name":"Affiliations"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/researcher":{"get":{"operationId":"get_v1_researcher","tags":["Researchers"],"summary":"A researcher's public profile","description":"","parameters":[{"name":"orcid","in":"query","required":true,"description":"ORCID iD, e.g. 0000-0002-1825-0097","schema":{"type":"string"},"example":"0000-0002-1825-0097"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"researcher":{"name":"Josiah Carberry","orcid":"0000-0002-1825-0097","keywords":["psychoceramics","ionian philology"],"websites":[{"url":"http://library.brown.edu/about/hay/carberry.php","name":"Brown University Page"},{"url":"http://en.wikipedia.org/wiki/Josiah_Carberry","name":"Wikipedia Entry"}],"biography":"Josiah Carberry is a fictitious person. This account is used as a demonstration account by ORCID, CrossRef and others who wish to demonstrate the interaction of ORCID with other scholarly communication systems without having to use a real-person's account.\r\n\r\nJosiah Stinkney Carberry is a fictional professor, created as a joke in 1929. He is said to still teach at Brown University, and to be known for his work in \"psychoceramics\", the supposed study of \"cracked pots\". See his Wikipedia entry for more details.","countries":[],"other_names":["Josiah Stinkney Carberry","J. Carberry","J. S. Carberry"],"external_ids":[{"type":"Scopus Author ID","value":"7007156898"}]}},"meta":{"timestamp":"2026-06-01T08:13:20.952Z","request_id":"8acbbfb0-349c-4e20-b3ae-c774d611f916"},"status":"ok","message":"Researcher retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Researchers"],"summary":"Search researchers","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Search text; Solr field syntax allowed, e.g. family-name:Smith","schema":{"type":"string"},"example":"family-name:Smith"},{"name":"start","in":"query","required":false,"description":"Result offset","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max results (1-100)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":20,"query":"family-name:Smith","start":0,"total":23740,"researchers":[{"name":"Andy Smith","orcid":"0000-0002-6814-660X","other_names":[],"institutions":[]},{"name":"Geoff Smith","orcid":"0000-0003-2450-4150","other_names":[],"institutions":[]},{"name":"Joshua Smith","orcid":"0000-0002-0208-6974","other_names":[],"institutions":[]},{"name":"Stuart Smith","orcid":"0000-0003-2533-9265","other_names":[],"institutions":[]},{"name":"M.A. (Peggy) Smith","orcid":"0000-0001-7474-940X","other_names":[],"institutions":["Lakehead University","University of Toronto"]},{"name":"Erica Smith","orcid":"0000-0002-7713-2189","other_names":[],"institutions":[]},{"name":"Cynthia Smith","orcid":"0000-0001-7134-8010","other_names":[],"institutions":[]},{"name":"Julie Smith","orcid":"0000-0001-5588-3638","other_names":[],"institutions":[]},{"name":"Steven Smith","orcid":"0000-0003-2612-2201","other_names":[],"institutions":[]},{"name":"Callie Smith","orcid":"0000-0003-0388-4019","other_names":[],"institutions":[]},{"name":"Tyler Smith","orcid":"0000-0002-6543-9562","other_names":[],"institutions":[]},{"name":"Jamison Smith","orcid":"0000-0003-2675-4858","other_names":[],"institutions":["Blue World Research Institute","Florida Institute of Technology","NOAA Fisheries Northeast Regional Office","NOAA Fisheries Office of Protected Resources","University of Central Florida"]},{"name":"Connor Smith","orcid":"0000-0003-0802-2063","other_names":[],"institutions":[]},{"name":"Shaquelle Smith","orcid":"0000-0003-4648-4007","other_names":[],"institutions":[]},{"name":"Amber Smith","orcid":"0000-0002-5612-1368","other_names":[],"institutions":[]},{"name":"Eric Smith","orcid":"0000-0002-0349-8022","other_names":[],"institutions":[]},{"name":"Alasdair Smith","orcid":"0000-0002-0989-0324","other_names":[],"institutions":[]},{"name":"Desomond smith","orcid":"0000-0003-3792-6694","other_names":[],"institutions":[]},{"name":"Dylan Smith","orcid":"0000-0003-4741-1942","other_names":[],"institutions":[]},{"name":"Quentin Smith","orcid":"0000-0002-5987-4867","other_names":[],"institutions":[]}]},"meta":{"timestamp":"2026-06-01T08:13:21.232Z","request_id":"9c6ccbcb-6f20-4840-b04b-1b363e412340"},"status":"ok","message":"Search results retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/works":{"get":{"operationId":"get_v1_works","tags":["Works"],"summary":"A researcher's published works","description":"","parameters":[{"name":"orcid","in":"query","required":true,"description":"ORCID iD","schema":{"type":"string"},"example":"0000-0002-1825-0097"},{"name":"limit","in":"query","required":false,"description":"Max works (1-200)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"count":6,"orcid":"0000-0002-1825-0097","total":6,"works":[{"doi":"10.5555/12345680","url":"https://doi.org/10.5555/12345680","type":"journal-article","year":"2012","title":"A Methodology for the Emulation of Architecture"},{"doi":"10.5555/666655554444","url":"https://doi.org/10.5555/666655554444","type":"journal-article","year":"2012","title":"The Memory Bus Considered Harmful"},{"doi":"10.5555/987654321","url":"https://doi.org/10.5555/987654321","type":"journal-article","year":"2011","title":"The Impact of Interactive Epistemologies on Cryptography"},{"doi":"10.5555/12345679","url":"https://doi.org/10.5555/12345679","type":"journal-article","year":"2008","title":"Developing Thin Clients Using Amphibious Epistemologies"},{"doi":"10.5555/12345678","url":"https://doi.org/10.5555/12345678","type":"journal-article","year":"2008","title":"Toward a Unified Theory of High-Energy Metaphysics: Silly String Theory"},{"doi":"10.1109/TPS.1987.4316723","url":"http://www.scopus.com/inward/record.url?eid=2-s2.0-0023398608&partnerID=MN8TOARS","type":"journal-article","year":"1987","title":"Bulk and surface plasmons in artificially structured materials","journal":"IEEE Transactions on Plasma Science"}]},"meta":{"timestamp":"2026-06-01T08:13:21.454Z","request_id":"c2223e1d-8787-40a8-89cf-df54136a296e"},"status":"ok","message":"Works retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/affiliations":{"get":{"operationId":"get_v1_affiliations","tags":["Affiliations"],"summary":"Employment & education history","description":"","parameters":[{"name":"orcid","in":"query","required":true,"description":"ORCID iD","schema":{"type":"string"},"example":"0000-0002-1825-0097"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"orcid":"0000-0002-1825-0097","educations":[],"employments":[{"role":"Professor","start":"1930-02-29","department":"Psychoceramics","organization":{"city":"Middletown","name":"Wesleyan University","region":"CT","country":"US"}},{"role":"Professor","start":"1929-02-29","department":"Psychoceramics","organization":{"city":"Providence","name":"Brown University","region":"RI","country":"US"}}]},"meta":{"timestamp":"2026-06-01T08:13:21.753Z","request_id":"47e9f803-a09a-4dfa-8c57-90dc1c913e89"},"status":"ok","message":"Affiliations retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Usage notes","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"data":{"note":"The global researcher identity registry. An ORCID iD (e.g. 0000-0002-1825-0097) uniquely and persistently identifies a researcher across journals, funders and institutions. /v1/search?q=family-name:Smith = search 15M+ researchers (Solr field syntax supported: family-name:, given-names:, affiliation-org-name:, keyword:, digital-object-ids:, ringgold-org-id:, or plain text) returning each match's ORCID iD, name, other names and institutions; /v1/researcher?orcid=0000-0002-1825-0097 = a researcher's public profile (name, credit name, other names, biography, research keywords, country, personal websites and external identifiers such as Scopus or ResearcherID); /v1/works?orcid=... = their published works (title, type, year, journal and DOI); /v1/affiliations?orcid=... = their employment and education history (organization, role, department and dates). ORCID iDs come from search results or are supplied by the researcher. Data from ORCID (public records only). For the scholarly works graph see the OpenAlex API, for DOIs the Crossref API.","source":"ORCID Public API (pub.orcid.org)","endpoints":["/v1/search","/v1/researcher","/v1/works","/v1/affiliations","/v1/meta"]},"meta":{"timestamp":"2026-06-01T08:13:21.825Z","request_id":"1e397f60-fecf-4943-9e45-8c5399ba1d3f"},"status":"ok","message":"Meta retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":580,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":720,"monthly_call_quota":21000,"rps_limit":6,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2250,"monthly_call_quota":92000,"rps_limit":15,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":6100,"monthly_call_quota":380000,"rps_limit":40,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/orcid-api"}