Get Reference List
crossref_get_referencesReturns the outgoing reference list for a DOI — the works cited by this paper. Each reference includes the deposited citation string and, where Crossref has resolved it, a DOI you can look up with crossref_get_work. Results are paged: referenceCount is the full deposited total, and when more remain the response carries a nextOffset to pass back as offset. Reference list coverage varies by publisher; many older works and non-participating publishers have no indexed references. Incoming citations — the works that cite this paper — are not available through Crossref; use OpenAlex for that.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"doi": "<doi>"
},
"name": "crossref_get_references"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| doi | Yes | DOI in the format "10.NNNN/suffix", e.g. "10.1038/nature12373". A resolver-wrapped form — "https://doi.org/10.1038/nature12373", "https://dx.doi.org/…", "doi:10.1038/nature12373" — is accepted and unwrapped. | |
| limit | No | Maximum number of references to return in one page (1–4000 per call, default 100). A larger value, up to 100000, returns 4000 and says so in notice; nextOffset continues after the references returned. Most works fit in a single page; bibliography records can carry tens of thousands. | |
| offset | No | Zero-based index of the first reference to return. Pass the nextOffset value from the previous response to continue through a long reference list. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cap | No | The limit that was applied to this page. | |
| doi | No | DOI of the citing work | |
| error | No | Present when the call failed. Absent on success. | |
| shown | No | Number of references returned in this page. | |
| notice | No | Coverage guidance when no references are indexed, a range explanation when the requested offset is past the end of the list, or which references this page covers and the offset that reaches the next ones. Leads with the value requested and the cap applied when limit was above its per-call cap. Absent on a page that holds the whole list with limit within its cap. | |
| offset | No | Zero-based index of the first returned reference within the deposited list | |
| truncated | No | True when references remain beyond this page. Absent when the page is the last. | |
| nextOffset | No | Offset to pass in the next call to retrieve the following page. Absent when this page reaches the end of the reference list. | |
| references | No | Page of the outgoing reference list | |
| referenceCount | No | Total number of references in the deposited list |