Skip to main content
POST
/
v1
/
bookings
Error
A valid request URL is required to generate request examples
{
  "id": "a3f1d7d0-ef1d-4b2e-aad2-123456789abc",
  "product": {
    "id": "a3f1d7d0-ef1d-4b2e-aad2-123456789abc",
    "reference": "one-day-pass",
    "name": "One Day Pass",
    "description": "Full day access to the coworking space including all amenities, meeting rooms, and common areas. Valid from 9:00 AM to 6:00 PM.",
    "price": 2500,
    "type": "one_time",
    "category": "booking",
    "metadata": {
      "durationType": "daily",
      "durationValue": 1
    },
    "currency": "EUR",
    "spaces": [
      "a3f1d7d0-ef1d-4b2e-aad2-123456789abc",
      "b4e2d8e1-fg2e-5c3f-bbe3-234567890bcd"
    ]
  },
  "space": {
    "name": "Meeting Room - 4 people",
    "label": "meeting-room-4-people",
    "description": "Modern meeting room equipped with a whiteboard, video conferencing capabilities, and Google Cast for presentations. Perfect for small team meetings.",
    "capacity": 4,
    "type": "meeting_room",
    "venue": {
      "name": "Downtown Event Center",
      "address": {},
      "label": "downtown-event-center",
      "type": "coworking",
      "spaces": [
        "<array>"
      ],
      "openingHours": [
        {
          "day": "monday",
          "open": "09:00",
          "close": "18:00"
        },
        {
          "day": "tuesday",
          "open": "09:00",
          "close": "18:00"
        }
      ],
      "metadata": {
        "import": "calendarId",
        "googleCalendarId": "primary"
      },
      "medias": [
        "<array>"
      ]
    },
    "products": [
      {
        "id": "a3f1d7d0-ef1d-4b2e-aad2-123456789abc",
        "reference": "one-day-pass",
        "name": "One Day Pass",
        "description": "Full day access to the coworking space including all amenities, meeting rooms, and common areas. Valid from 9:00 AM to 6:00 PM.",
        "price": 2500,
        "type": "one_time",
        "category": "booking",
        "metadata": {
          "durationType": "daily",
          "durationValue": 1
        },
        "currency": "EUR",
        "spaces": [
          "a3f1d7d0-ef1d-4b2e-aad2-123456789abc",
          "b4e2d8e1-fg2e-5c3f-bbe3-234567890bcd"
        ]
      }
    ],
    "metadata": {
      "color": "#FF0000",
      "amenities": [
        "whiteboard",
        "projector",
        "wifi"
      ],
      "equipment": [
        "laptop",
        "monitor"
      ]
    },
    "totalBookings": 0
  },
  "status": "PENDING",
  "bookingDate": "2024-01-15T09:00:00.000Z",
  "customer": {
    "id": "a3f1d7d0-ef1d-4b2e-aad2-123456789abc",
    "type": "individual",
    "email": "[email protected]",
    "phone": "+33612345678",
    "name": "John Doe",
    "companyName": "Doe Industries",
    "siren": "732829320",
    "tvaNumber": "FR12732829320",
    "address": "10 Rue de Paris, 75001 Paris, France"
  },
  "slot": {
    "from": "2024-01-15T09:00:00.000Z",
    "to": "2024-01-15T17:00:00.000Z"
  },
  "additionalProducts": [
    {
      "id": "prod_123",
      "quantity": 2
    },
    {
      "id": "prod_456",
      "quantity": 1
    }
  ]
}

Authorizations

​
Authorization
string
header
required

OAuth2 authentication for Boseat API

Body

application/json
​
productId
string<uuid>
required

Unique identifier of the product to book. The product defines pricing, duration, and booking conditions.

Example:

"a3f1d7d0-ef1d-4b2e-aad2-123456789abc"

​
spaceId
string<uuid>
required

Unique identifier of the space to book. The space represents the physical location or resource being reserved.

Example:

"b4e2d8e1-fg2e-5c3f-bbe3-234567890bcd"

​
slot
object
required

Time slot for the booking, specifying when the reservation starts and ends. The slot must be available and within the space's operating hours.

​
email
string

Email address of the customer making the booking. Used for booking confirmation emails and customer identification. Optional during initial booking creation but required for confirmation.

Example:

"[email protected]"

​
phone
string

Phone number of the customer in French format. Used for booking confirmations and customer support. Optional during initial booking creation but required for confirmation.

Example:

"+33612345678"

Response

Booking created successfully in PENDING status. Use the PATCH endpoint to confirm the booking with customer details.

​
id
string<uuid>
required

Unique identifier (UUID) of the booking.

Example:

"a3f1d7d0-ef1d-4b2e-aad2-123456789abc"

​
product
object
required

Product associated with this booking. Contains pricing information, duration rules, and booking conditions that apply to this reservation.

​
space
object
required

Space that has been reserved. Contains details about the physical location, capacity, and amenities available for this booking.

​
status
enum<string>
required

Current status of the booking. Possible values: PENDING (awaiting confirmation), CONFIRMED (confirmed and active), CANCEL (cancelled).

Available options:
RESERVED_15_MIN,
PENDING,
REFUNDED,
CANCEL,
CONFIRMED,
PAID
Example:

"PENDING"

​
bookingDate
string<date-time>
required

Date and time when the booking was created in the system. Format: ISO 8601 date-time.

Example:

"2024-01-15T09:00:00.000Z"

​
customer
object
required

Customer information for the person or entity who made the booking. Includes contact details and customer type.

​
slot
object
required

Time slot for the booking, specifying the exact start and end times when the space is reserved.

​
additionalProducts
object[]

Additional products or services included with this booking. These are supplementary items beyond the main product (e.g., catering, equipment rental, parking).

Example:
[
  { "id": "prod_123", "quantity": 2 },
  { "id": "prod_456", "quantity": 1 }
]