GET /tools/idconv/api/v1/articles/
Summary: Convert between PMID, PMCID, and DOI
Operation ID: idConverter
Auth: unknown
Operation ID: idConverter
Auth: unknown
Description
Converts between various article identifiers: PubMed IDs (PMID), PubMed Central IDs (PMCID), Manuscript IDs (MID), and DOIs. Supports up to 200 identifiers per request.
Parameters (7)
email
(string, query, optional)
Contact email address
format
(string, query, optional, default: xml)
Output format
Constraints: {'enum': ['xml', 'json', 'csv', 'html']}
ids
(string, query, required)
Comma-separated list of identifiers (up to 200). PMCIDs should include 'PMC' prefix.
idtype
(string, query, optional)
Override auto-detection: pmcid, pmid, mid, or doi
Constraints: {'enum': ['pmcid', 'pmid', 'mid', 'doi']}
showaiid
(string, query, optional, default: no)
Expose Article Instance IDs for versioned articles
Constraints: {'enum': ['yes', 'no']}
tool
(string, query, optional)
Application name for logging
versions
(string, query, optional, default: no)
Include version history and author manuscript IDs
Constraints: {'enum': ['yes', 'no']}
Examples (2)
| Title | Type | URL | Action |
|---|---|---|---|
| Convert single PMID to all formats (XML output) | curl |
https://www.ncbi.nlm.nih.gov/pmc/tools/idconv/api/v1/articles/?ids=25355835&email=user@example.com |
|
| Batch convert multiple PMCIDs with version history | curl |
https://www.ncbi.nlm.nih.gov/pmc/tools/idconv/api/v1/articles/?ids=PMC4221869%2CPMC3533815&versions=yes&showaiid=yes&format=json&email=user@example.com |
Probe History
Status Codes
| Time | Status | Latency | Size |
|---|---|---|---|
| 2026-03-23 10:16:46.228276 | 200 | 509ms | |
| 2026-03-23 09:48:01.250221 | 200 | 559ms |
Response Changes
| When | Old | New |
|---|---|---|
| 2026-03-23 10:16:46.228276 | 394b56019414 |
c415cb44c657 |