# ORCID API
> 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.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/orcid-api/..."
```

## Pricing
- **Free** (Free) — 580 calls/Mo, 2 req/s
- **Starter** ($7/Mo) — 21,000 calls/Mo, 6 req/s
- **Pro** ($23/Mo) — 92,000 calls/Mo, 15 req/s
- **Mega** ($61/Mo) — 380,000 calls/Mo, 40 req/s

## Endpoints

### Researchers

#### `GET /v1/researcher` — A researcher's public profile

**Parameters:**
- `orcid` (query, required, string) — ORCID iD, e.g. 0000-0002-1825-0097 Example: `0000-0002-1825-0097`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/orcid-api/v1/researcher?orcid=0000-0002-1825-0097"
```

**Response:**
```json
{
    "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": [],
            "credit_name": null,
            "other_names": [
                "Josiah Stinkney Carberry",
                "J. Carberry",
                "J. S. Carberry"
            ],
            "external_ids": [
                {
                    "type": "Scopus Author ID",
                    "value": "7007156898"
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/search` — Search researchers

**Parameters:**
- `q` (query, required, string) — Search text; Solr field syntax allowed, e.g. family-name:Smith Example: `family-name:Smith`
- `start` (query, optional, string) — Result offset
- `limit` (query, optional, string) — Max results (1-100)

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/orcid-api/v1/search?q=family-name%3ASmith"
```

**Response:**
```json
{
    "data": {
        "count": 20,
        "query": "family-name:Smith",
        "start": 0,
        "total": 23740,
        "researchers": [
            {
                "name": "Andy Smith",
                "orcid": "0000-0002-6814-660X",
                "credit_name": null,
                "other_names": [],
                "institutions": []
            },
            {
                "name": "Geoff Smith",
                "orcid": "0000-0003-2450-4150",
                "credit_name": null,
                "other_names": [],
                "institutions": []
            },
            {
                "name": "Joshua Smith",
                "orcid": "0000-0002-0208-6974",
                "credit_name": null,
                "other_names": [],
                "institutions": []
            },
            {
                "name": "Stuart Smith",
                "orcid": "0000-0003-2533-9265",
                "credit_name": null,
                "other_names": [],
                "institutions": []
            },
            {
                "name": "M.A. (Peggy) Smith",
                "orcid": "0000-0001-7474-940X",
                "credit_name": null,
                "other_names": [],
                "institutions": [
                    "Lakehead University",
                    "University of Toronto"
                ]
            },
            {
                "name": "Erica Smith",
                "orcid": "0000-0002-7713-2189",
                "credit_name
…(truncated, see openapi.json for full schema)
```

### Works

#### `GET /v1/works` — A researcher's published works

**Parameters:**
- `orcid` (query, required, string) — ORCID iD Example: `0000-0002-1825-0097`
- `limit` (query, optional, string) — Max works (1-200)

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/orcid-api/v1/works?orcid=0000-0002-1825-0097"
```

**Response:**
```json
{
    "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",
                "journal": null
            },
            {
                "doi": "10.5555/666655554444",
                "url": "https://doi.org/10.5555/666655554444",
                "type": "journal-article",
                "year": "2012",
                "title": "The Memory Bus Considered Harmful",
                "journal": null
            },
            {
                "doi": "10.5555/987654321",
                "url": "https://doi.org/10.5555/987654321",
                "type": "journal-article",
                "year": "2011",
                "title": "The Impact of Interactive Epistemologies on Cryptography",
                "journal": null
            },
            {
                "doi": "10.5555/12345679",
                "url": "https://doi.org/10.5555/12345679",
                "type": "journal-article",
                "year": "2008",
                "title": "Developing Thin Clients Using Amphibious Epistemologies",
                "journal": null
            },
            {
                "doi": "10.5555/12345678",
                "url": "https://doi.org/10.5555/12345678",

…(truncated, see openapi.json for full schema)
```

### Affiliations

#### `GET /v1/affiliations` — Employment & education history

**Parameters:**
- `orcid` (query, required, string) — ORCID iD Example: `0000-0002-1825-0097`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/orcid-api/v1/affiliations?orcid=0000-0002-1825-0097"
```

**Response:**
```json
{
    "data": {
        "orcid": "0000-0002-1825-0097",
        "educations": [],
        "employments": [
            {
                "end": null,
                "role": "Professor",
                "start": "1930-02-29",
                "department": "Psychoceramics",
                "organization": {
                    "city": "Middletown",
                    "name": "Wesleyan University",
                    "region": "CT",
                    "country": "US"
                }
            },
            {
                "end": null,
                "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
}
```

### Meta

#### `GET /v1/meta` — Usage notes

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/orcid-api/v1/meta"
```

**Response:**
```json
{
    "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",
    
…(truncated, see openapi.json for full schema)
```


---
Marketplace page: https://www.oanor.com/api/orcid-api
OpenAPI spec: https://www.oanor.com/api/orcid-api/openapi.json