> ## 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/storefront.json get /api/v1/flipbooks
openapi: 3.1.0
info:
  title: Vellaro Storefront API
  description: >-
    The API of storefronts and mobile apps. The store comes from the publishable
    key in the `X-Vellaro-Key` header (or from the store's domain); the
    customer's endpoints also take the customer's token as `Authorization:
    Bearer <access_token>`.
  version: 0.1.0
servers:
  - url: https://api.vellaro.io
    description: Produzione
security: []
tags:
  - name: Authentication
    description: >-
      Customer sign-up and login, tokens, password reset, email verification,
      Google and Apple login, two-factor authentication.
  - name: Catalog
    description: Products, categories and brands, with filters, sorting and pagination.
  - name: Search
    description: Full-text product search and suggestions as you type.
  - name: Cart
    description: >-
      The cart of a guest (`X-Cart-Token`) or of the logged-in customer, and the
      extra warranty offered on a product page.
  - name: Checkout & orders
    description: >-
      Checkout, the customer's orders and reorder, «Order on WhatsApp» (cart
      codes, clicks).
  - name: Payments
    description: >-
      The store's payment methods, paying an order again, and the confirmation
      steps of PayPal, PokPay and Iute.
  - name: Account
    description: >-
      The logged-in customer: profile, addresses, wishlist, digital downloads,
      subscriptions, affiliate account.
  - name: Reviews & questions
    description: Product reviews and product questions.
  - name: AI chat
    description: 'The store''s AI shopping assistant: conversations, messages, feedback.'
  - name: Content
    description: CMS pages, menus, banners, flipbooks and information pages.
  - name: Marketing & contact
    description: >-
      Newsletter sign-up and email links, the contact form, campaign click
      tracking.
  - name: Store
    description: >-
      The store for the storefront: brand, public settings, languages,
      translations, currencies, physical stores, theme.
  - name: Devices
    description: Push-notification devices of the mobile app.
paths:
  /api/v1/flipbooks:
    get:
      tags:
        - Content
      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.