Get Work by DOI
crossref_get_workResolves a DOI to its full Crossref metadata record: title, authors, editors, affiliations, abstract (when deposited), journal or container with the volume, issue, pages, and article number that locate the work in it, ISSNs and ISBNs, publication date, type, license, full-text links, and funder acknowledgements. Where the record deposits them it also carries the conference event of a proceedings paper (event), the approval date that dissertations and most standards deposit in place of a publication date (approved, never read into published), the institutions a record names (the awarding institution of a thesis, the server of a preprint, the laboratories behind a report) and the degree of a thesis, and the subtype and group title of posted content such as a preprint. The author list is paged: authorCount is the full deposited total, offset and limit select the page (25 authors by default), and when authors remain the response carries a nextOffset to pass back as offset — large-collaboration papers deposit thousands. A grant, which deposits no title or abstract, carries its award number (award), award start, and projects: titles, descriptions, lead and co-lead investigators, investigators, amounts, dates, and funding, each funder with its Funder Registry DOI or ROR. Its investigators are paged by offset and limit the way authors are, across its projects in deposited order, with investigatorCount the full total; lead and co-lead investigators come back whole. A peer review carries review — its stage, type, running number, revision round, recommendation, competing-interest statement, and language, where deposited. Post-publication updates are relayed as Crossref records them: updatedBy names each correction, retraction, expression of concern, or new version issued against this work, with its notice DOI and whether the publisher or Retraction Watch recorded it, and updateTo names the works this record is itself a notice for. An absent updatedBy does not mean the work was never updated — coverage depends on those deposits. relations lists related identifiers, such as a preprint and its published version, grouped by relation type; only the Crossref-registered DOIs among them resolve through crossref_get_work. The record of a preprint can leave out its published version, so on a posted-content record of subtype preprint a second request reads publishedVersions: the works whose own records name it in has-preprint, each with its DOI, type, and title. Every other record takes one request. clinicalTrialNumbers lists the trial registrations the work names, each with its registry where deposited, and assertions the Crossmark entries its publisher attaches — received, revised, and accepted dates, ethics and competing-interest statements, peer-review details — both returned whole in deposited order; an absent clinicalTrialNumbers does not mean the work reports no trial. memberId is the Crossref member that holds the DOI now — pass it to crossref_get_member for the publisher record and its deposit coverage; the prefix of the DOI names the member that registered the prefix, which for a transferred title is a former publisher. Outgoing references are reported as a count in referencesCount; the reference entries themselves come from crossref_get_references. The isReferencedByCount field reports the total incoming citation count from Crossref; the citing works themselves are not available through Crossref — use OpenAlex for citation graphs.
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_work"
}
}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 authors — on a grant, investigators — to return in one page (1–10000 per call, default 25). A larger value, up to 100000, returns 10000 and says so in notice; nextOffset continues after the entries returned. Ordinary records fit in a single page; large-collaboration papers in particle physics and genomics deposit thousands of authors, and some grants hundreds of investigators. | |
| offset | No | Zero-based index of the first author to return — on a grant, which deposits no authors, the first investigator, counted across its projects in deposited order. Pass the nextOffset value from the previous response to continue through a long list. Only the author and investigator lists are paged; every other field of the record, lead and co-lead investigators included, is returned in full on every page. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cap | No | The limit that was applied to this page of authors or investigators. | |
| doi | No | Canonical DOI | |
| url | No | DOI resolution URL | |
| isbn | No | ISBN(s) as deposited — for a book chapter, those of the containing book. Omitted when the record deposits none. | |
| issn | No | ISSN(s) of the containing journal | |
| page | No | Page range as deposited, e.g. "357-362" | |
| type | No | Work type (e.g. journal-article, book-chapter, posted-content) | |
| award | No | Award number of a grant as deposited — the value a funded work's funders[].award cites. Omitted on a record depositing none. | |
| error | No | Present when the call failed. Absent on success. | |
| event | No | Conference or meeting the work was presented at, as a proceedings record deposits it: name, acronym, location, and dates, each where deposited. Omitted when the record deposits none. | |
| issue | No | Issue of the container the work appears in | |
| links | No | Registered full-text links | |
| shown | No | Number of authors — on a grant, investigators — returned in this page. | |
| title | No | Work title | |
| degree | No | Degree a thesis was submitted for, as deposited, e.g. "Doutorado em Educação". Omitted when the record deposits none. | |
| notice | No | When updatedBy is present, the update types Crossref records for this work with the source of each, and where the notice is read. Then, on a posted-content preprint, that the published-version lookup failed and publishedVersions is omitted, or that more than 10 works name the preprint, with the total — either way naming the crossref_search_works filter that runs the lookup. Then, when limit was above its per-call cap, the value requested and the cap applied. Then which authors — on a grant, which investigators — this page covers and the offset that reaches the next ones, or an explanation when the requested offset is past the end of the list. All share this one string when more than one applies. Absent when the page holds the whole list, no update is recorded, any published-version lookup returned every work naming the preprint, and limit was within its cap. | |
| offset | No | Zero-based index of the first returned author — on a grant, the first returned investigator — within the deposited list. Omitted when the record deposits neither an author field nor an investigator list. | |
| review | No | Review details a peer-review record deposits — stage, type, running number, revision round, recommendation, competing-interest statement, and language — each where deposited. The reviewed work is named in relations, under is-review-of. Omitted when the record deposits none. | |
| volume | No | Volume of the container the work appears in | |
| authors | No | Page of the author and contributor list, bounded by limit. Omitted when the record deposits no author field at all. | |
| editors | No | Editors of the work, or of the book or proceedings containing it, in the entry shape authors use. Returned whole — never paged by offset and limit, and never counted in authorCount. Omitted when the record deposits none. | |
| funders | No | Funding acknowledgements | |
| subject | No | Subject classification terms | |
| subtype | No | Kind of posted content as deposited, e.g. preprint or other. Omitted when the record deposits none. | |
| abstract | No | Abstract when deposited by the publisher. Many records lack abstracts, and one whose deposit holds no text is omitted the same way. Publishers deposit it as JATS XML, so this is the text of that deposit with markup removed and character references decoded; each section heading of a structured abstract is followed by a colon ("Objectives: …") unless it already ends in a period, colon, question mark, or exclamation mark, a heading whose section holds no text (a figure-only "Graphical Abstract") is dropped, the "Abstract" heading a deposit opens with is dropped, and the items of one list are joined by "; " unless an item already ends in a period, comma, semicolon, colon, question mark, or exclamation mark; numeric JATS superscripts retain caret notation (10^{16}, GeV^2), a link keeps its tag only where its href holds an address the text it wraps does not already carry, and each formula appears once — MathML as the TeX annotation it carries, otherwise written out linearly (x_i, A^{−1}, √(m), (a+b)/c), and TeX deposited beside MathML in whichever notation comes first. | |
| approved | No | Date the work was approved, as deposited — the only date most dissertations and standards carry, and one some reports carry beside their publication date. Never read into published, which stays absent on a record that deposits no publication date. A component Crossref records as unknown is omitted, and so is every component below it. Omitted when the record deposits none. | |
| language | No | Language code (ISO 639) | |
| licenses | No | License terms | |
| memberId | No | Crossref member ID of the publisher that holds this DOI now — pass to crossref_get_member for its record. The DOI's prefix names the member that registered the prefix, which for a transferred title is a former publisher. Omitted when the record deposits no member. | |
| projects | No | Projects a grant funds, in deposited order; every sampled grant deposits one. A grant deposits no title or abstract — its project titles and descriptions stand in for them. Omitted on a record depositing none. | |
| subtitle | No | Subtitle when present | |
| updateTo | No | Works this record is an update notice for, in the entry shape updatedBy uses and in deposited order. Omitted when the record is not registered as a notice. | |
| published | No | Publication date — the first of published, published-print, published-online, and issued that names one. A component Crossref records as unknown is omitted, and so is every component below it. A grant deposits only issued, which Crossref sets to the award start, so on a grant this is the award start. | |
| publisher | No | Publisher name | |
| relations | No | Related identifiers — preprints and published versions, other versions, reviews, supplements, parts — grouped by relation type, identifier type, and asserting party, groups in Crossref's order and ids in deposited order. Returned whole. Omitted when the record deposits none. A preprint's own record can leave out its published version while the article's record still names the preprint: on a posted-content preprint, publishedVersions lists the works whose records name it, which crossref_search_works also finds with the filter relation.type has-preprint and relation.object this record's DOI. | |
| truncated | No | True when authors — on a grant, investigators — remain beyond this page. Absent when the page is the last. | |
| updatedBy | No | Update notices Crossref records against this work — corrections, errata, retractions, expressions of concern, withdrawals, new versions — in deposited order. Entries are never merged: the same notice DOI can appear once per source, typed differently by each. Omitted when none is recorded, which does not mean the work was never updated: coverage depends on publisher and Retraction Watch deposits. | |
| assertions | No | Crossmark assertions the publisher attaches — article history (received, revised, accepted, published online), ethics and competing-interest statements, peer-review details, and boilerplate such as copyright — returned whole in deposited order, which is their sequence. Omitted when the record deposits none. | |
| awardStart | No | Award start a grant deposits at the record level. Some funders deposit the start only per project, under projects[].start. Components Crossref records as unknown are omitted, as on published. Omitted when not deposited. | |
| groupTitle | No | Group title as deposited on posted content — the collection or subject a server files the work under, such as "Developmental Biology" on bioRxiv, or the server itself, such as "SSRN". Omitted when the record deposits none. | |
| nextOffset | No | Offset to pass in the next call to retrieve the following page of authors — on a grant, of investigators. Absent when this page reaches the end of the list. | |
| authorCount | No | Total number of authors in the deposited list, before offset and limit were applied. Omitted alongside authors when the record deposits no author field. | |
| institutions | No | Institutions the record names, in deposited order — the awarding institution of a thesis, the server a preprint was posted to, the laboratories behind a report — read wherever deposited, whatever the work type. Distinct from publisher, which for many theses names a library or repository and for many preprints the platform company. Omitted when the record deposits none. | |
| articleNumber | No | Article number, deposited by journals that number articles instead of paging them | |
| containerTitle | No | Journal, book, or proceedings name containing this work — the first entry of containerTitles | |
| containerTitles | No | Every container title the record deposits, in deposited order. A book chapter or proceedings paper often deposits two: the series, then the book or volume. Omitted when the record deposits none. | |
| referencesCount | No | Number of outgoing references (works cited by this paper) | |
| investigatorCount | No | Total investigators across the projects of a grant, before offset and limit were applied. Lead and co-lead investigators, returned whole, are not counted. Omitted when no project deposits an investigator list. | |
| publishedVersions | No | On a posted-content record of subtype preprint, the works whose own records name it in has-preprint — its published version, usually one article — read by a second request. At most 10: when more name it, notice gives the total and the crossref_search_works filter that lists every one. An empty list means no Crossref record names this preprint. Omitted on every other record, and when the lookup failed, which notice then says — an absent list never means no published version. A work here can also appear in relations, which reads this record's own deposit; the two lists are separate deposits and neither is deduplicated against the other. | |
| isReferencedByCount | No | Incoming citation count from Crossref — the count of works citing this DOI | |
| clinicalTrialNumbers | No | Clinical trial registrations the work names, returned whole in deposited order — a number deposited twice appears twice. Omitted when the record deposits none, which does not mean the work reports no trial: coverage depends on the publisher's deposit. |