# Add Items To Booking

<mark style="color:green;">`POST`</mark> `[PlatformAddress]/api/1.0/venue?action=addItemsToBooking`

Add one or more items to a booking.

#### Request Body

| Name      | Type    | Description                                                              |
| --------- | ------- | ------------------------------------------------------------------------ |
| venueId   | integer | The unique id of the venue to which the booking belongs                  |
| bookingId | integer | The unique id of the booking to which the additional items will be added |
| items     | object  | Array of multiple items with additional item details                     |

{% tabs %}
{% tab title="200 " %}

```
{
  "success": true,
  "items": [
    501
  ]
}
```

{% endtab %}
{% endtabs %}

Multiple items can be added together. There must be at least one additional item.

### Example Request

```javascript
{
  "venueId": 2,
  "bookingId": 2,
  "items": [
    {
      "description": "The complete description of the additional item",
      "quantity": 10,
      "salePrice": 500,
      "salePriceHasTax": true,
      "salePriceTaxId": 2,
      "cost": 15,
      "costHasTax": true,
      "costCentreId": 5,
      "costCentreType": 2,
      "startDate": "2015-01-19 00:00:00 UTC",
      "endDate": "2015-01-22 00:00:00 UTC",
      "excludedFromCommissions": true
    }
  ]
}
```

### Additional item details

| Property                | Description                                                                                                                                                      | Type      |
| ----------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------- |
| description             | The complete description of the additional item                                                                                                                  | string    |
| quantity                | The quantity of the additional item                                                                                                                              | number    |
| salePrice               | The sale price per quantity of the additional item. This amount will be interpreted as including or excluding a tax component based on the venue’s tax settings. | number    |
| salePriceHasTax         | Whether or not the sale price of the additional item has a tax component                                                                                         | boolean   |
| salePriceTaxId          | The unique identifier of the venue tax. Use getTaxList api to get the list of venue taxes.                                                                       | number    |
| cost                    | The cost per quantity of the additional item                                                                                                                     | number    |
| costHasTax              | Whether or not the cost of the additional item has a tax component                                                                                               | boolean   |
| costCentreId            | The unique identifier of the cost centre to which the additional item will be assigned                                                                           | number    |
| costCentreType          | The type of cost centre to which the additional item will be assigned                                                                                            | number    |
| startDate               | Optionally the start date of the additional item, which must fall within the dates of the booking                                                                | timestamp |
| endDate                 | Optionally the end date of the additional item, which must fall within the dates of the booking                                                                  | timestamp |
| excludedFromCommissions | Whether or not agents receive commission for the additional item                                                                                                 | boolean   |

### Returns

| Property | Description                                                                     |
| -------- | ------------------------------------------------------------------------------- |
| success  | Whether or not the items were added to the booking                              |
| items    | The unique identifiers of the additional items in the same order as the request |

### Throws

| Code                 | Description                                |
| -------------------- | ------------------------------------------ |
| Specific Code: 24140 | There must be at least one additional item |
| Specific Code: 24141 | An additional item has invalid 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.ivvy.com/venues/getoraddbookingdata/add-items-to-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.