# Booking

Booking is where you'll be able to create a booking interaction with a certain customer. This is great for applications that offer booking systems to hospitality venues.

## Create a Booking

<mark style="color:green;">`POST`</mark> `v1/guests/:guest_id/booking`

#### Request Body

| Name                                          | Type                                                                                                                                                                                   | Description                                                                                                                                                                |
| --------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| amount                                        | Number                                                                                                                                                                                 | Transaction amount in currencies lowest common denominator                                                                                                                 |
| currency                                      | ISO 4217                                                                                                                                                                               |                                                                                                                                                                            |
| venue\_id<mark style="color:red;">\*</mark>   | String                                                                                                                                                                                 | The venue ID that the booking is applicable for. You obtain this from /venues path, attribute: id                                                                          |
| event\_id<mark style="color:red;">\*</mark>   | String                                                                                                                                                                                 | The identifier of the booking, usually the ID of your booking within your application.                                                                                     |
| status<mark style="color:red;">\*</mark>      | 'active' \| 'arrived' \| 'partially\_seated' \| 'seated' \| 'appetizer' \| 'entree' \| 'dessert' \| 'cleared' \| 'check\_dropped' \| 'paid' \| 'complete' \| 'cancelled' \| 'no\_show' |                                                                                                                                                                            |
| party\_size<mark style="color:red;">\*</mark> | Number                                                                                                                                                                                 | The number of covers for the booking.                                                                                                                                      |
| metadata                                      | Object                                                                                                                                                                                 | Optional key-value object containing any other information that is related to the booking. For example, this could contain booking notes of the customer or any allergens. |
| starts\_at<mark style="color:red;">\*</mark>  | ISO 8601                                                                                                                                                                               | Start date and time of the booking                                                                                                                                         |
| ends\_at<mark style="color:red;">\*</mark>    | ISO 8601                                                                                                                                                                               | End date and time of the booking                                                                                                                                           |
| created\_at                                   | String                                                                                                                                                                                 |                                                                                                                                                                            |
| updated\_at                                   | String                                                                                                                                                                                 |                                                                                                                                                                            |
| type                                          | String                                                                                                                                                                                 | The type of booking for example "Drinks Room" or "Food Only".                                                                                                              |

### Updating the Data of a Booking

As bookings over time change for example a party size increases or the status of the booking is updated, you will be able to use the `event_id` of your booking and resend the <mark style="color:green;">`POST`</mark> request with the updated data.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.stampede.ai/guests/booking.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.