List Zenodo record versions
zenodo_list_versionsRead-onlyIdempotent
List every version of a Zenodo deposit's version series, newest first, with each version's record id, DOI, version label, publication date, file totals, and usage counts. Accepts any identifier zenodo_get_record accepts; a concept DOI and any single version's DOI list the same series. Use it to find the version a paper cited or the current release. A miss (an unknown id, a deleted record with its removal tombstone, restricted metadata, or a DOI not registered on Zenodo) returns found: false with guidance instead of an error.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | Any version or concept identifier of the deposit: a record id (22705923), a Zenodo DOI (10.5281/zenodo.22705923) or concept DOI (10.5281/zenodo.591564), another DOI registered to a Zenodo record, or a zenodo.org/records or doi.org URL. | |
| page | No | Result page, starting at 1. page × size may not exceed 10,000. | |
| size | No | Versions per page (1–25). |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cap | No | Page size applied. | |
| page | No | Page returned. | |
| size | No | Page size applied. | |
| error | No | Present when the call failed. Absent on success. | |
| found | No | True when the version series resolved. | |
| shown | No | Versions returned on this page. | |
| notice | No | Guidance on paging or a page past the end. | |
| guidance | No | What to do next. Present when not found. | |
| has_more | No | True when another page of versions follows. | |
| versions | No | Versions on this page, newest first; empty when not found. | |
| miss_kind | No | Why nothing resolved. Present when not found. | |
| next_page | No | The next page number, when has_more. | |
| tombstone | No | Removal tombstone. Present when miss_kind is deleted. | |
| truncated | No | True when more versions follow this page. | |
| input_kind | No | How id was parsed: record_id (digits), zenodo_doi (10.5281/zenodo.N or zenodo.N), external_doi (another DOI), or url (a zenodo.org or doi.org link). | |
| totalCount | No | Number of versions in the series. | |
| concept_doi | No | Concept DOI of the series, when minted; absent when not found or on a page past the end. | |
| latest_recid | No | Record id of the newest version. Present when found, unless Zenodo cannot name it for a page past the end. | |
| concept_recid | No | Concept record id naming the whole series; absent when not found or on a page past the end. | |
| total_versions | No | Number of versions in the series. Present when found. |