resolveIdentifier
Resolves a single bibliographic identifier to canonical CSL JSON metadata via the Scholar Sidekick resolver chain (Crossref → PubMed → DataCite → arXiv → ADS → ISBN → WHO IRIS, with deterministic fallback order).
When to use
- The user provides a single DOI (including a shortDOI alias like
10/aabbe), PMID, PMCID, ISBN, ISSN, arXiv ID, ADS bibcode, or WHO IRIS URL and wants the underlying metadata.
- An agent needs structured fields (author list, title, container, year, identifiers) before formatting or exporting.
Inputs
identifier (string, required) — DOI like 10.1038/nphys1170, PMID like 34812345, ISBN, etc. Detection is automatic. A shortDOI alias (10/aabbe, from shortdoi.org) is accepted anywhere a DOI is, and expanded to the full DOI before resolving.
Outputs
CSL JSON with at least title, author[], issued, container-title, DOI/PMID/PMCID/URL (depending on source). Errors return { ok: false, code, error }.
Underlying surfaces
- REST:
POST /api/format with text: "<identifier>" and output: "json" returns the resolved item alongside the formatted string.
- MCP tool:
resolveIdentifier in scholar-sidekick-mcp.
Example
curl -sS -X POST "https://scholar-sidekick.com/api/format" \
-H "Content-Type: application/json" \
-d '{"text":"10.1038/nphys1170","style":"vancouver","output":"text"}'
See also
formatCitation for rendering, verifyCitation for fabrication detection.
/llms.txt for the full service description.
1---2name: resolve-identifier3description: Resolve a scholarly identifier (DOI incl. shortDOI aliases/PMID/PMCID/ISBN/ISSN/arXiv/ADS/WHO IRIS) to structured CSL JSON metadata.4---56# resolveIdentifier78Resolves a single bibliographic identifier to canonical CSL JSON metadata via the Scholar Sidekick resolver chain (Crossref → PubMed → DataCite → arXiv → ADS → ISBN → WHO IRIS, with deterministic fallback order).910## When to use1112- The user provides a single DOI (including a shortDOI alias like `10/aabbe`), PMID, PMCID, ISBN, ISSN, arXiv ID, ADS bibcode, or WHO IRIS URL and wants the underlying metadata.13- An agent needs structured fields (author list, title, container, year, identifiers) before formatting or exporting.1415## Inputs1617- `identifier` (string, required) — DOI like `10.1038/nphys1170`, PMID like `34812345`, ISBN, etc. Detection is automatic. A shortDOI alias (`10/aabbe`, from shortdoi.org) is accepted anywhere a DOI is, and expanded to the full DOI before resolving.1819## Outputs2021CSL JSON with at least `title`, `author[]`, `issued`, `container-title`, `DOI`/`PMID`/`PMCID`/`URL` (depending on source). Errors return `{ ok: false, code, error }`.2223## Underlying surfaces2425- **REST**: `POST /api/format` with `text: "<identifier>"` and `output: "json"` returns the resolved item alongside the formatted string.26- **MCP tool**: `resolveIdentifier` in [`scholar-sidekick-mcp`](https://github.com/mlava/scholar-sidekick-mcp).2728## Example2930```bash31curl -sS -X POST "https://scholar-sidekick.com/api/format" \32 -H "Content-Type: application/json" \33 -d '{"text":"10.1038/nphys1170","style":"vancouver","output":"text"}'34```3536## See also3738- `formatCitation` for rendering, `verifyCitation` for fabrication detection.39- [`/llms.txt`](https://scholar-sidekick.com/llms.txt) for the full service description.