List Published Journal Versions
biorxiv_list_published_versionsList preprints that appeared as journal articles within a journal publication-date interval, each with its journal DOI, journal name, publication date, and preprint metadata — the same record biorxiv_get_published_version returns for one DOI. The dates filter on journal publication, not preprint posting, so most rows were posted months or years earlier; use biorxiv_list_recent for preprints posted in an interval. publisher, a journal DOI prefix such as 10.7554 for eLife, limits the listing to the bioRxiv preprints published under it; those rows carry no journal name, authors, or abstract, and a prefix api.biorxiv.org does not recognize raises invalid_publisher. Returns limit publications per server (default 25, up to 100 — the page api.biorxiv.org serves; a larger limit returns 100 and says so). Continue at the nextCursor a page returns rather than stepping cursor by a fixed amount; limit: 100 walks an interval in the fewest calls. When server="both" (default), per-server pagination state is returned separately, since one cursor can be past the end of one server and inside the other — to continue a single server, pass its nextCursor with server set to that server. One server failing under server="both" does not abort the call: the other server's page is still returned and the failed one is named in failed[]. Every attempted server failing raises a retryable upstream_unavailable (or rate_limited) error rather than an empty page. Abstracts are omitted by default to keep the page small — pass include_abstract: true for the whole page. Every preprintDoi, 10.1101/ and 10.64898/ alike, is accepted by biorxiv_get_preprint and the other DOI tools.
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": {
"start_date": "<start_date>",
"end_date": "<end_date>"
},
"name": "biorxiv_list_published_versions"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Rows to return per queried server, starting at cursor. Defaults to 25. Up to 100, the page api.biorxiv.org serves: a larger value returns 100 rows per server and says so in the notice. limit: 100 walks an interval in the fewest calls. | |
| cursor | No | Integer row offset, applied to each queried server. Defaults to 0 (first page). To continue, pass the nextCursor the previous page returned for that server — it advances by the rows actually served. | |
| server | No | Preprint server to list. "both" lists bioRxiv and medRxiv in parallel; their rows do not overlap. | both |
| end_date | Yes | End of the journal publication-date interval (YYYY-MM-DD), inclusive. | |
| publisher | No | Journal publisher filter: the DOI prefix its journal articles share, the part before the slash — "10.7554" for eLife, "10.1016" for Elsevier. Lists only the bioRxiv preprints published under that prefix: medRxiv has no publisher listing, so server="both" queries bioRxiv alone and server="medrxiv" is rejected. Rows listed this way carry no journal name, authors, corresponding author, or abstract. | |
| start_date | Yes | Start of the journal publication-date interval (YYYY-MM-DD), inclusive. | |
| include_abstract | No | Include each preprint's abstract. Defaults to false: abstracts make up about three quarters of a page, and every other field is returned either way. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cap | No | Most publications this page can hold: rows per server (limit, or 100 when limit asked for more) times the servers queried. Set with truncated. | |
| error | No | Present when the call failed. Absent on success. | |
| shown | No | Publications on this page, across every server queried. Set with truncated. | |
| failed | No | Servers that did not answer, so their rows are missing from "publications" and they have no "pagination" entry. Non-empty means this result set is partial — retry to include them. Only populated under server="both", and never holding every attempted server: when none answered, the call fails with upstream_unavailable or rate_limited instead. Distinct from an exhausted pagination entry, where the server answered. | |
| notice | No | Guidance on how to read this result set: which servers did not answer, that a publisher filter limited server="both" to bioRxiv and which fields its rows lack, a limit above the 100-row page, which cursors are past the end, which servers have rows past this page, and — when nothing came back — the interval and how to broaden it. All applicable qualifications are composed into one string. | |
| truncated | No | True when at least one server has rows past this page — continue at that server's nextCursor. Absent when every server queried is on its last page. | |
| pagination | No | Per-server pagination state. Advance each server independently. | |
| publications | No | Publications in the interval, in upstream order: bioRxiv rows first, then medRxiv rows. |