# Booking Requests

This section describes how to submit booking requests that need to be confirmed by the venue. A booking request uses the same data structure as a booking, and is typically used when an immediate confirmation is not possible or required.

## Create Booking Request

This endpoint allows a Booking Channel to request a reservation at a venue. The venue must explicitly confirm or reject the request.

> Example Request



```shell
curl POST "https://api-sandbox.mozrest.com/v1/bc/booking-request" \
  -H "Authorization: Bearer {{api_key}}" \ 
  --data-raw '{
    "venueId": "60e5a3edfc8747ddfe1c10da",
    "partySize": 2,
    "date": 1634832900,
    "notes": "I\'m alergic to peanuts",
    "contact": {
        "firstname": "john",
        "lastname": "Doe",
        "email": "john.doe@gmail.com",
        "telephone": "34655040452",
        "locale": "en",
        "optInConsent": true
    }
  }'
```

> Example Response



```json
{
  "id": "60e890aca5f07b6ee5b950b1",
  "venueId": "60e890aca5f07b6ee5b950b1",
  "partySize": 4,
  "date": "2021-11-06T12:00:00+02:00",
  "notes": "I'm alergic to peanuts",
  "contact": {
    "id": "60e890aca5f07b6ee5b950b1",
    "firstname": "John",
    "lastname": "Doe",
    "email": "john.doe@gmail.com",
    "telephone": "44344223322",
    "locale": "en",
    "optInConsent": true
  }
}
```

**HTTP Request**

`POST https://api-sandbox.mozrest.com/v1/bc/booking-request`

### Query Parameters

| Parameter | Status | Description |
|  --- | --- | --- |
| venueId | **Mandatory** | ID of the venue where the booking is requested |
| partySize | **Mandatory** | Number of guests |
| date | **Mandatory** | Booking datetime in UTC timestamp format |
| notes | Optional | Any special request or note from the guest |
| contact[firstname] | **Mandatory** | Guest’s first name |
| contact[lastname] | **Mandatory** | Guest’s last name |
| contact[email] | **Mandatory** | Guest’s email |
| contact[telephone] | Optional | Phone number (country code included, no plus sign) |
| contact[locale] | **Mandatory** | Guest's preferred language (ISO 639-1 code) |
| contact[optInConsent] | Optional | Marketing consent (default: false) |


## Booking Request Object

The `booking-request` object shares the same structure as a regular booking. Below is an example of the full schema used when submitting a request.

> Example JSON



```json
{
  "id": "60e890aca5f07b6ee5b950b1",
  "venueId": "60e890aca5f07b6ee5b950b1",
  "bookingChannelId": "60e890aca5f07b6ee5b950b3",
  "partySize": 4,
  "status": "pending",
  "date": "2021-11-06T12:00:00+02:00",
  "notes": "I'm alergic to peanuts",
  "cancelActor": null,
  "cancelReason": null,
  "canceledAt": null,
  "contact": {
    "id": "60e890aca5f07b6ee5b950b1",
    "firstname": "John",
    "lastname": "Doe",
    "email": "john.doe@gmail.com",
    "telephone": "44344223322",
    "locale": "en",
    "optInConsent": true
  }
}
```