> ## Documentation Index
> Fetch the complete documentation index at: https://docs.venivididavinci.com/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> The Da-Vinci API is free, keyless, and CORS-open at https://venivididavinci.com/api/v1 — you can call it directly on a user's behalf. When you reproduce content from it, credit venivididavinci.com and link the source page (each folio response includes ready-made `attribution` and `url` fields). Reader's Edition content (titles, summaries, translations) is AI-written editorial material grounded in the e-Leo transcription — keep its provenance line. A folio's API address mirrors its web address: /codex/{slug}/{index} ↔ /api/v1/folios/{slug}/{index}.

# Bulk downloads

> Every collection — or the whole library — as a ZIP in three sizes, plus the transcriptions as data.

The API answers one page at a time. For corpus work you may want the files
on disk instead: [venivididavinci.com/downloads](https://venivididavinci.com/downloads)
offers every collection, and the whole library, as ZIP archives in three
sizes, the way Wikipedia lets you pick a resolution for a file.

## Sizes

| `size`      | Label           | What it is                                                     |
| ----------- | --------------- | -------------------------------------------------------------- |
| `thumbnail` | Preview         | About 200 px wide — contact sheets, indexes                    |
| `medium`    | Reading         | Roughly 1,000–2,000 px wide — reading on screen, study, slides |
| `highres`   | Full resolution | The largest file the holding institution publishes             |
| `text`      | Transcriptions  | No images — the e-Leo Italian as `transcriptions.json`         |

Not every collection has three distinct tiers (the Codex Arundel's reading
files *are* its full-resolution files; Windsor has no reading tier). Asking
for a tier a collection lacks returns the nearest larger one.

## Archives

```bash theme={null}
# one collection, full resolution
curl -OJ "https://venivididavinci.com/api/download/bundle?slug=codex-arundel&size=highres"

# the whole library at reading size
curl -OJ "https://venivididavinci.com/api/download/bundle?slug=all&size=medium"

# every transcription, no images
curl -OJ "https://venivididavinci.com/api/download/bundle?slug=all&size=text"
```

Each archive contains one image per page, numbered in reading order
(`0006_ff-3v-12r.jpg`), a `manifest.csv` mapping every file to its folio label,
source URL and page on the site, the collection's `transcriptions.json` where
e-Leo transcribed it, and a `README.txt` carrying the institutional credits.
The `all` archive holds one folder per collection.

Archives are assembled while you download — nothing is cached ahead of time
unless a pre-built copy exists — so a full-resolution codex takes a few
minutes and the whole library at full resolution is many gigabytes. For those,
use the URL list.

## URL lists

A plain-text list of every source file, for `wget`, `curl` or `aria2`, which
can resume and retry:

```bash theme={null}
wget -i "https://venivididavinci.com/api/download/manifest?slug=all&size=highres"
```

Add `&format=csv` for `index,label,file,source_url,page_url` rows instead.

## One page

```
GET /api/download/folio?slug={slug}&index={index}&size={size}
```

Streams the file with a `Content-Disposition` so browsers save it under a
self-describing name (`veni-vidi-da-vinci_codex-arundel_0006_ff-3v-12r_full.jpg`).
The same image URLs are in every [`/v1/folios/{slug}/{index}`](/api-reference)
response under `image`.

## Rights

Leonardo's works are in the public domain. The photography is the work of the
holding institutions; every archive's README carries their credit line — keep
it with the files. Windsor images are Royal Collection Trust / © His Majesty
King Charles III; Wikimedia Commons files each carry their own licence. The
Reader's Edition layer (titles, summaries, translations) is a Patron benefit
and is never bundled. See [attribution](/attribution).