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

# Introduction

> Welcome to the BookingShake API documentation. Automate event creation and manage bookings programmatically.

## Welcome to BookingShake API

The BookingShake API provides a simple, RESTful interface for integrating event and booking management into your applications. Whether you're building a custom booking form, integrating with your existing systems, or automating event creation, our API makes it easy.

## Base URL

All API requests should be made to:

```
https://api.bookingshake.io/api
```

## API Version

Current version: **v1.0**

## What You Can Do

<CardGroup cols={2}>
  <Card title="Create Events" icon="calendar-plus" href="/api-reference/events/create">
    Create single or multiple bookings with contact and company information
  </Card>

  <Card title="Manage Resources" icon="database" href="/api-reference/sources">
    Retrieve booking sources, spaces, and statuses
  </Card>

  <Card title="Custom Fields" icon="sliders" href="/api-reference/fields">
    Access all available fields including custom configurations
  </Card>

  <Card title="Webhooks" icon="webhook" href="/api-reference/webhooks/introduction">
    Receive real-time notifications when accounts and contacts change
  </Card>

  <Card title="Authentication" icon="key" href="/api-reference/authentication">
    Secure API access with Bearer token authentication
  </Card>
</CardGroup>

## Key Features

* **Event Creation**: Create one or multiple events in a single request
* **Contact Management**: Link events to existing contacts or create new ones
* **Draft Quotations**: Include products to create draft quotations
* **Resource Management**: Access booking sources, spaces, and statuses
* **Custom Fields**: Support for venue-specific custom fields
* **Group Bookings**: Create multiple events that are automatically grouped together
* **Webhooks**: Real-time event notifications for account and contact changes

## Getting Started

<Steps>
  <Step title="Get Your API Key">
    Navigate to **Settings > Integrations** in your BookingShake dashboard and copy your API key.
  </Step>

  <Step title="Read the Authentication Guide">
    Learn how to authenticate your requests using Bearer tokens.

    [View Authentication Guide →](/api-reference/authentication)
  </Step>

  <Step title="Make Your First Request">
    Follow our quickstart guide to create your first event.

    [View Quickstart Guide →](/api-reference/quickstart)
  </Step>

  <Step title="Explore Endpoints">
    Dive into the API reference to discover all available endpoints.

    [Browse API Reference →](/api-reference/events/create)
  </Step>
</Steps>

## Need Help?

<CardGroup cols={2}>
  <Card title="Quickstart Guide" icon="rocket" href="/api-reference/quickstart">
    Get up and running in minutes with practical examples
  </Card>

  <Card title="Error Handling" icon="triangle-exclamation" href="/api-reference/errors">
    Learn about status codes and how to handle errors
  </Card>

  <Card title="Use Cases" icon="lightbulb" href="/api-reference/use-cases">
    Real-world examples and integration patterns
  </Card>

  <Card title="Support" icon="life-ring" href="mailto:support@bookingshake.com">
    Contact our support team for assistance
  </Card>
</CardGroup>

## Important Data Formats

<AccordionGroup>
  <Accordion title="Pricing Format (Products/Quotations)" icon="euro-sign">
    When creating events with products for draft quotations, prices and VAT must use specific formats:

    **Prices (`price_without_tax`)**:

    * Provided in **cents/centimes**, not euros/dollars
    * Example: €150.00 = `150000` cents
    * Example: €35.50 = `3550` cents

    **VAT (`vat`)**:

    * Provided in **basis points** (1/100th of a percent), not percentages
    * Example: 20% VAT = `2000` basis points
    * Example: 10% VAT = `1000` basis points
    * Example: 5.5% VAT = `550` basis points
    * Valid range: `0` to `10000` (0% to 100%)

    **Why this format?**
    This ensures precision for financial calculations and avoids floating-point rounding errors.
  </Accordion>

  <Accordion title="Date and Time Format" icon="calendar">
    All dates and times must follow specific formats:

    **Dates**:

    * Format: `DD-MM-YYYY`
    * Example: `"15-03-2025"` for March 15, 2025

    **Times**:

    * Format: `HH:mm` (24-hour format)
    * Example: `"14:30"` for 2:30 PM
    * Example: `"09:00"` for 9:00 AM
  </Accordion>
</AccordionGroup>

## Rate Limits

The BookingShake API implements rate limiting to ensure fair usage and service quality:

* **POST /events/create**: 10 requests per minute
* **GET endpoints** (sources, spaces, status, fields): 60 requests per minute

Rate limit information is provided in response headers. See the [Rate Limiting Guide](/api-reference/rate-limiting) for details.

## API Stability

The BookingShake API is production-ready and actively maintained. We're committed to backward compatibility and will announce any breaking changes well in advance.