> For the complete documentation index, see [llms.txt](https://docs.venuzle.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.venuzle.com/manager-api/internal-endpoints/partner/venue-prices.md).

# Venue prices

## Create venue price

<mark style="color:blue;">`GET`</mark> `/api/internal/v1/partners/:partner_id/venue-prices`

Create a new venue price.

#### Path Parameters

| Name        | Type    | Description            |
| ----------- | ------- | ---------------------- |
| partner\_id | integer | The ID of the partner. |

#### Request Body

| Name                   | Type    | Description                                                       |
| ---------------------- | ------- | ----------------------------------------------------------------- |
| vat\_id                | integer | The ID of the VAT to be applied.                                  |
| type                   | string  | The type of the price. At the moment only `default` is supported. |
| name                   | string  | A name to easily recognize the price later.                       |
| form                   | string  | The form of the price. Allowed values: `net`, `gross`.            |
| amount                 | number  | The price amount.                                                 |
| usable\_online         | boolean | Indicate if the price should be usable online or not.             |
| description            | string  | A description for the price.                                      |
| venue\_ids\_to\_attach | array   | The IDs of the venues to which this price should be attached.     |

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

```
```

{% endtab %}
{% endtabs %}

## Get venue price

<mark style="color:blue;">`GET`</mark> `/api/internal/v1/partners/:partner_id/venue-prices/:venue_price_id`

Get the given venue price.

#### Path Parameters

| Name             | Type    | Description                |
| ---------------- | ------- | -------------------------- |
| partner\_id      | integer | The ID of the partner.     |
| venue\_price\_id | integer | The ID of the venue price. |

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

```
 
```

{% endtab %}
{% endtabs %}

## Update venue price

<mark style="color:orange;">`PUT`</mark> `/api/internal/v1/partners/:partner_id/venue-prices/:venue_price_id`

Update the given venue price.

#### Path Parameters

| Name             | Type    | Description                |
| ---------------- | ------- | -------------------------- |
| partner\_id      | integer | The ID of the partner.     |
| venue\_price\_id | integer | The ID of the venue price. |

#### Request Body

| Name                   | Type    | Description |
| ---------------------- | ------- | ----------- |
| name                   | string  |             |
| description            | string  |             |
| form                   | string  |             |
| amount                 | number  |             |
| vat\_id                | integer |             |
| usable\_online         | boolean |             |
| venue\_ids\_to\_attach | array   |             |

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

```
```

{% endtab %}
{% endtabs %}

{% hint style="danger" %}
If the update request will alter the final amount of the price (amount, VAT or form is changed), the current price will be soft-deleted and a new one will be created. Because of that, the new price will have a different ID than the current one.\
\
This happens because if an existent price is already used by existent bookings, we want to preserve the price of that bookings.
{% endhint %}

## Delete venue price

<mark style="color:red;">`DELETE`</mark> `/api/internal/v1/partners/:partner_id/venue-prices/:venue_price_id`

#### Path Parameters

| Name             | Type    | Description                |
| ---------------- | ------- | -------------------------- |
| partner\_id      | integer | The ID of the partner.     |
| venue\_price\_id | integer | The ID of the venue price. |

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

```
```

{% endtab %}
{% endtabs %}