# List insurances
Source: https://docs.boxpilote.fr/api-reference/endpoint/insurances/get

GET /api/public/v1/insurances
Lists insurances for the authenticated center with pagination.



# Create opportunity
Source: https://docs.boxpilote.fr/api-reference/endpoint/opportunities/create

POST /api/public/v1/opportunities/create
Creates a new business opportunity linked to an existing client or automatically creates a new client.



# List products
Source: https://docs.boxpilote.fr/api-reference/endpoint/products/get

GET /api/public/v1/products
Lists products for the authenticated center with pagination.



# Create quote
Source: https://docs.boxpilote.fr/api-reference/endpoint/quotes/create

POST /api/public/v1/quotes
Creates a new quote with customer and quote items. Amounts in euros.



# List quotes
Source: https://docs.boxpilote.fr/api-reference/endpoint/quotes/get

GET /api/public/v1/quotes
Lists all quotes for the authenticated center with pagination. Returns a summary (id, quote_number, total_amount, status, customer). Optional date and status filters.



# Get quote by ID
Source: https://docs.boxpilote.fr/api-reference/endpoint/quotes/get-by-id

GET /api/public/v1/quotes/{id}
Gets a single quote by ID with full details including customer and quote items.



# List rentals
Source: https://docs.boxpilote.fr/api-reference/endpoint/rentals/get

GET /api/public/v1/rentals
Lists rentals for the authenticated center with pagination.



# List services
Source: https://docs.boxpilote.fr/api-reference/endpoint/services/get

GET /api/public/v1/services
Lists services for the authenticated center with pagination.



# List surfaces
Source: https://docs.boxpilote.fr/api-reference/endpoint/surfaces/get

GET /api/public/v1/surfaces
Lists surfaces for the authenticated center with pagination.



# List VAT rates
Source: https://docs.boxpilote.fr/api-reference/endpoint/vat-rates/get

GET /api/public/v1/vat-rates
Lists VAT rates with pagination.



# Introduction
Source: https://docs.boxpilote.fr/api-reference/introduction

Boxpilote Public API Reference

<Note>
  A valid Boxpilote account is mandatory to access and utilize this API. If you don't already have an account, please contact Boxpilote support to request access.
</Note>

## Welcome

The Boxpilote API allows users to automate business processes and manage their data: opportunities, quotes, surfaces, rentals, insurances, services, products, and VAT rates. This reference uses the OpenAPI specification to document available endpoints, authentication, and usage.

**Base URL:** `https://api.boxpilote.fr`

<CardGroup>
  <Card title="Opportunities" icon="building" href="/api-reference/endpoint/opportunities/create">
    Create business opportunities
  </Card>

  <Card title="Quotes" icon="file-invoice" href="/api-reference/endpoint/quotes/get">
    List all quotes
  </Card>

  <Card title="Create quote" icon="file-invoice-dollar" href="/api-reference/endpoint/quotes/create">
    Create a new quote
  </Card>

  <Card title="Quote by ID" icon="file-invoice-dollar" href="/api-reference/endpoint/quotes/get-by-id">
    Get quote by ID
  </Card>

  <Card title="Surfaces" icon="layer-group" href="/api-reference/endpoint/surfaces/get">
    List surfaces
  </Card>

  <Card title="Rentals" icon="key" href="/api-reference/endpoint/rentals/get">
    List rentals
  </Card>

  <Card title="Insurances" icon="shield-halved" href="/api-reference/endpoint/insurances/get">
    List insurances
  </Card>

  <Card title="Services" icon="wrench" href="/api-reference/endpoint/services/get">
    List services
  </Card>

  <Card title="Products" icon="box" href="/api-reference/endpoint/products/get">
    List products
  </Card>

  <Card title="VAT Rates" icon="percent" href="/api-reference/endpoint/vat-rates/get">
    List VAT rates
  </Card>
</CardGroup>

## Authentication

All API endpoints are secured via Bearer tokens, as specified in the OpenAPI file

```json theme={null}
"headers": [
  {
    "Authorization": Bearer <your_token_here>
  }
]
```

## Rate Limiting

The API enforces **throttling**: max 500 requests per second per API key.

### When exceeded

If you exceed the limit, the API returns **429 (Too Many Requests)** with:

> Rate limit exceeded (N requests per second).