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

# List rentals

> Lists rentals for the authenticated center with pagination.



## OpenAPI

````yaml GET /api/public/v1/rentals
openapi: 3.1.0
info:
  title: Boxpilote API
  description: >-
    API for business opportunities, quotes, surfaces, rentals, insurances,
    services, products, VAT rates, and associated clients.
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.boxpilote.fr
security:
  - bearerAuth: []
paths:
  /api/public/v1/rentals:
    get:
      description: Lists rentals for the authenticated center with pagination.
      parameters:
        - name: page
          in: query
          description: 'Page number (default: 1)'
          schema:
            type: integer
            default: 1
            minimum: 1
        - name: limit
          in: query
          description: 'Items per page (default: 20, max: 100)'
          schema:
            type: integer
            default: 20
            minimum: 1
            maximum: 100
      responses:
        '200':
          description: List of rentals with pagination
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/Rental'
                  pagination:
                    type: object
                    properties:
                      page:
                        type: integer
                      limit:
                        type: integer
                      total:
                        type: integer
                      totalPages:
                        type: integer
        '401':
          description: Unauthorized / Invalid Token
          content:
            application/json:
              example:
                success: false
                message: 'Unauthorized: Invalid or missing token.'
        '500':
          description: Error fetching rentals
          content:
            application/json:
              example:
                success: false
                message: Erreur récupération des locations
components:
  schemas:
    Rental:
      type: object
      properties:
        id:
          type: string
        created_at:
          type: string
          format: date-time
        availability:
          type: string
          nullable: true
        dimensions:
          type: string
          nullable: true
        rental_number:
          type: string
          nullable: true
        surface_id:
          type: string
          nullable: true
        details:
          type: string
          nullable: true
        largeur:
          type: number
          nullable: true
          description: Width
        longueur:
          type: number
          nullable: true
          description: Length
        hauteur:
          type: number
          nullable: true
          description: Height
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````