List Zenodo record files
zenodo_list_filesRead-onlyIdempotent
Page through a Zenodo deposit's file manifest (key, size, MIME type, MD5, download URL, previewability), optionally filtered by a substring of the file key, or list the members inside one of its .zip files by setting archive_key. Restricted and embargoed files return the access status and embargo date with no entries. Read a small text file or ZIP member with zenodo_read_file.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The deposit: a record id (22705923), a Zenodo DOI (10.5281/zenodo.22705923), another DOI registered to a Zenodo record, or a zenodo.org/records or doi.org URL. A concept id lists the latest version’s files. | |
| limit | No | Entries per page (1–200). | |
| offset | No | Entries to skip before this page. | |
| archive_key | No | Exact file key of a .zip in this record (from the manifest) to list its members instead of the manifest. Omit to list the manifest. | |
| key_contains | No | Case-insensitive substring filter on file keys (manifest) or member paths (archive), applied before paging. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cap | No | Page size applied. | |
| kind | No | manifest: the record’s files; archive: members of the .zip named by archive_key. | |
| error | No | Present when the call failed. Absent on success. | |
| limit | No | Page size applied. | |
| recid | No | Record id whose files are listed (the latest version for a concept id). | |
| shown | No | Entries returned on this page. | |
| notice | No | File access notes, empty-filter guidance, listing caps, or paging guidance. | |
| offset | No | Entries skipped before this page. | |
| archive | No | The archive being listed (archive kind); absent when files are restricted. | |
| entries | No | Manifest files on this page (manifest kind); empty when files are restricted. | |
| matched | No | Entries matching the filter, before paging. | |
| members | No | Archive members on this page (archive kind); empty when files are restricted. | |
| has_more | No | True when more matching entries follow this page. | |
| truncated | No | True when more matching entries follow this page. | |
| file_count | No | Total files in the record (manifest kind); absent when files are restricted or embargoed. | |
| totalCount | No | Entries matching the filter, before paging. | |
| next_offset | No | Offset of the next page, when has_more. | |
| total_bytes | No | Total size of the record’s files in bytes (manifest kind); absent when files are restricted or embargoed. | |
| files_access | No | File access: public or restricted; absent when Zenodo does not report it. | |
| key_contains | No | The key filter applied, when set. | |
| access_status | No | Record access status: open, restricted, embargoed, or metadata-only. | |
| embargo_until | No | Embargo end date, when an embargo is active. | |
| files_enabled | No | False for a metadata-only deposit. |