> ## 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}.

# Quickstart

> Your first request in under a minute — no key required.

The API is open: no signup, no key, no SDK needed. Base URL:

```text theme={null}
https://venivididavinci.com/api/v1
```

<Steps>
  <Step title="Fetch a random page">
    ```bash theme={null}
    curl "https://venivididavinci.com/api/v1/random"
    ```

    You get one complete manuscript page — scan URLs, Leonardo's original Italian,
    and the full Reader's Edition layer:

    ```json theme={null}
    {
      "slug": "codex-flight-of-birds",
      "index": 6,
      "label": "c 03 recto",
      "folios": ["3|r"],
      "image": {
        "highRes": "https://codex.venivididavinci.com/codices/codex-flight-of-birds/highres/MsVaria95-c.03.recto.jpg"
      },
      "enrichment": {
        "title": "Mechanical Science, Balances, and the Centre of Gravity",
        "subjects": ["physics-and-mechanics", "machines-and-devices"],
        "summary": "The page opens with Leonardo's declaration that mechanical science is the most noble and useful of all…",
        "english": [{ "order": 1, "textEN": "Instrumental or mechanical science is most noble…" }]
      },
      "url": "https://venivididavinci.com/codex/codex-flight-of-birds/6",
      "attribution": "Reader's Edition — venivididavinci.com/codex/codex-flight-of-birds/6"
    }
    ```
  </Step>

  <Step title="Browse a collection">
    List all 28 collections, then page through one:

    ```bash theme={null}
    curl "https://venivididavinci.com/api/v1/collections"
    curl "https://venivididavinci.com/api/v1/collections/codex-flight-of-birds?limit=10"
    ```
  </Step>

  <Step title="Search the library">
    Full-text search over titles, summaries, and the English translations:

    ```bash theme={null}
    curl "https://venivididavinci.com/api/v1/search?q=flying+machine&limit=5"
    ```

    Filter by subject or collection:

    ```bash theme={null}
    curl "https://venivididavinci.com/api/v1/search?q=wing&subject=flight&collection=codex-atlanticus"
    ```
  </Step>

  <Step title="Fetch a specific page">
    A folio is addressed exactly like its page on the website —
    `venivididavinci.com/codex/{slug}/{index}` ↔ `/api/v1/folios/{slug}/{index}`:

    ```bash theme={null}
    curl "https://venivididavinci.com/api/v1/folios/codex-atlanticus/1646"
    ```
  </Step>
</Steps>

## Common recipes

<AccordionGroup>
  <Accordion title="Page of the day">
    `GET /random` with a subject filter, once a day:

    ```bash theme={null}
    curl "https://venivididavinci.com/api/v1/random?subject=anatomy"
    ```
  </Accordion>

  <Accordion title="Everything Leonardo wrote about water">
    ```bash theme={null}
    curl "https://venivididavinci.com/api/v1/subjects/hydraulics?limit=100"
    ```

    Walk `offset` until you reach `total`. Each entry links to the full folio.
  </Accordion>

  <Accordion title="Download high-res scans for a collection">
    List the collection, fetch each folio, and read `image.highRes`:

    ```bash theme={null}
    curl "https://venivididavinci.com/api/v1/folios/paris-ms-b/80" | jq -r .image.highRes
    ```
  </Accordion>
</AccordionGroup>

<Note>
  Anonymous requests are limited to 60/hour per IP. If you're building something
  real, [get a key](/authentication) — it's free.
</Note>