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

# List Public Flipbooks

> Public: i flipbook pubblicati e pronti, come schede leggere.

Dichiarata PRIMA di `/{slug}`: FastAPI risolve in ordine di registrazione e
un percorso vuoto non collide, ma tenerle vicine nell'ordine giusto evita
che una futura rotta letterale finisca inghiottita dal segnaposto.



## OpenAPI

````yaml https://api.vellaro.io/openapi.json get /api/v1/flipbooks
openapi: 3.1.0
info:
  title: Vellaro API
  description: Vellaro 2026 — E-commerce API
  version: 0.1.0
servers:
  - url: https://api.vellaro.io
    description: Produzione
security: []
tags: []
paths:
  /api/v1/flipbooks:
    get:
      tags:
        - flipbooks
      summary: List Public Flipbooks
      description: >-
        Public: i flipbook pubblicati e pronti, come schede leggere.


        Dichiarata PRIMA di `/{slug}`: FastAPI risolve in ordine di
        registrazione e

        un percorso vuoto non collide, ma tenerle vicine nell'ordine giusto
        evita

        che una futura rotta letterale finisca inghiottita dal segnaposto.
      operationId: list_public_flipbooks_api_v1_flipbooks_get
      parameters:
        - name: homepage
          in: query
          required: false
          schema:
            anyOf:
              - type: boolean
              - type: 'null'
            description: Solo i flipbook con la spunta «pubblica in homepage»
            title: Homepage
          description: Solo i flipbook con la spunta «pubblica in homepage»
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ApiResponse_list_FlipbookCardOut__'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
components:
  schemas:
    ApiResponse_list_FlipbookCardOut__:
      properties:
        data:
          anyOf:
            - items:
                $ref: '#/components/schemas/FlipbookCardOut'
              type: array
            - type: 'null'
          title: Data
        meta:
          anyOf:
            - $ref: '#/components/schemas/PaginationMeta'
            - type: 'null'
        error:
          anyOf:
            - type: string
            - type: 'null'
          title: Error
        error_code:
          anyOf:
            - type: string
            - type: 'null'
          title: Error Code
      type: object
      title: ApiResponse[list[FlipbookCardOut]]
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    FlipbookCardOut:
      properties:
        slug:
          type: string
          title: Slug
        title_i18n:
          anyOf:
            - additionalProperties: true
              type: object
            - type: 'null'
          title: Title I18N
        page_count:
          type: integer
          title: Page Count
        cover_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Cover Url
      type: object
      required:
        - slug
        - title_i18n
        - page_count
      title: FlipbookCardOut
      description: >-
        Public — la scheda che la vetrina mostra: copertina, titolo, indirizzo.


        Volutamente SENZA l'elenco delle pagine: la homepage ne disegna il
        richiamo,

        non il visualizzatore. Mandare 40 pagine per una copertina sarebbe una

        risposta 20 volte piu' grande di quanto serve, moltiplicata per ogni

        visita alla home.
    PaginationMeta:
      properties:
        page:
          type: integer
          title: Page
        page_size:
          type: integer
          title: Page Size
        total:
          type: integer
          title: Total
        total_pages:
          type: integer
          title: Total Pages
      type: object
      required:
        - page
        - page_size
        - total
        - total_pages
      title: PaginationMeta
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
        input:
          title: Input
        ctx:
          type: object
          title: Context
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.