# Change Booking Status

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

Changes the current status of a venue booking.

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

```javascript
{
  "success": true,
  "id": 1234,
}
```

{% endtab %}

{% tab title="400 " %}

```javascript
{
    "errorCode": 400,
    "message": "The request contains invalid data",
    "specificCode": 24397,
    "additionalMessages": [
        "convertedStageId: *Value is required and can't be empty*"
    ]
}
```

{% endtab %}

{% tab title="500 " %}

```javascript
{
  "errorCode": 500,
  "message": "An error has occurred",
  "specificCode": 24346,
  "additionalMessages": []
}
```

{% endtab %}
{% endtabs %}

### Request Details

| Property                   | Type                                                                                                                                                                                                 | Required | Description                                                                                                                                                                                                                                                                                     |
| -------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| id                         | integer                                                                                                                                                                                              | required | The unique id of the booking whose status will be changed.                                                                                                                                                                                                                                      |
| venueId                    | integer                                                                                                                                                                                              | required | The unique id of the venue to which the booking belongs.                                                                                                                                                                                                                                        |
| currentStatus              | [Current Status](#booking-status)                                                                                                                                                                    | required | The new status to assign the booking.                                                                                                                                                                                                                                                           |
| changedByUserId            | integer                                                                                                                                                                                              | optional | The unique id of the user who changed the status of the booking. The user assigned to the api key will be used when this parameter is not set.                                                                                                                                                  |
| cancelStageId              | integer                                                                                                                                                                                              | optional | The id of the stage to assign to the opportunity when cancelling a quote (i.e. changing from a prospective status to cancelled).                                                                                                                                                                |
| cancelReasonId             | integer                                                                                                                                                                                              | optional | The id of the stage reason to assign to the opportunity/booking being cancelled. When cancelling a quote (i.e. changing from a prospective status to cancelled), the value must belong to the "cancelStageId" stage. When cancelling a booking, the value must belong to the "cancelled" stage. |
| cancelLostToCompetition    | string                                                                                                                                                                                               | optional | A description of how the cancelled booking was lost to competition.                                                                                                                                                                                                                             |
| cancelClosedDate           | date                                                                                                                                                                                                 | optional | The date when booking was cancelled. Required when the booking status is changing to cancelled.                                                                                                                                                                                                 |
| convertedStageId           | integer                                                                                                                                                                                              | optional | The id of the stage to assign to the opportunity to which the booking belongs. Required when changing the status to anything but cancelled.                                                                                                                                                     |
| convertedStageReasonId     | integer                                                                                                                                                                                              | optional | The id of the stage reason to assign to the opportunity to which the booking belongs. Can be set when changing the status to anything but cancelled.                                                                                                                                            |
| marketplaceStageReasonType | [Marketplace Stage Reason Type](https://github.com/ivvycode/apidocs/tree/7af24821fc40ba1f468b10f3e52c14e3bbb74fd0/venues/getoraddbookingdata/change-booking-status.mb#marketplace-stage-reason-type) | optional | This is the official regretted reason that will be sent to the booker when the opportunity is regretted. Required when "convertedStageId" is the regretted stage.                                                                                                                               |
| convertedClosedDate        | date                                                                                                                                                                                                 | optional | The date when quote (ie. a prospective status) is being converted to booking (ie. Tentative or Confirmed). Required when booking is being closed (i.e. Prospective/ProspectiveHold to Tentative or Confirmed and lead stage is either won or lost).                                             |

### Booking Status

The following booking status options are supported.

| Value | Description      |
| ----- | ---------------- |
| 1     | Prospective      |
| 2     | Tentative        |
| 3     | Confirmed        |
| 4     | Cancelled        |
| 9     | Prospective Hold |

### Marketplace Stage Reason Type

The following marketplace stage reason are supported

| Value | Description                                 |
| ----- | ------------------------------------------- |
| 1     | Accommodation unavailable                   |
| 2     | Accommodation capacity - too small          |
| 3     | Conference/Event space unavailable          |
| 4     | Conference/Event space capacity - too small |
| 5     | Conference/Event space capacity - too big   |
| 6     | Facilities not suitable                     |
| 7     | No reason given                             |


---

# 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/change-booking-status.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.