# Cart

## Create cart

<mark style="color:green;">`POST`</mark> `https://api.voordemensen.nl/v1/:client_name/cart/`

A `POST` HTTP request is sent. A shopping cart is created. The `Location` header is used to link to the newly created resource (the cart) in order for the client to be able to access it without querying anew. Save the cart\_id to the session if you want to access it again.

#### Path Parameters

| Name         | Type   | Description                                                        |
| ------------ | ------ | ------------------------------------------------------------------ |
| client\_name | string | the short name identifying you as a VdM client e.g. demo or fringe |

{% tabs %}
{% tab title="201 Cart created" %}

```
{"cart_id":"4DSMDACyPo8wLr8vFnTVUR6HzWC5tWGi"}
```

{% endtab %}
{% endtabs %}

## Put seat(s) in the cart

<mark style="color:green;">`POST`</mark> `https://api.voordemensen.nl/v1/:client_name/cart/:cart_id`

A `POST` HTTP request is used to put a seat in the cart. The event\_id, number of tickets and discount\_id is sent as part of the request body. The reply contains all cart data in order not to force the client to query again for it.

#### Path Parameters

| Name         | Type   | Description                                                        |
| ------------ | ------ | ------------------------------------------------------------------ |
| cart\_id     | string | the cart\_id identifying this cart                                 |
| client\_name | string | the short name identifying you as a VdM client e.g. demo or fringe |

#### Request Body

| Name            | Type    | Description                             |
| --------------- | ------- | --------------------------------------- |
| discount\_id    | string  | the id of the ticket type (or discount) |
| numberoftickets | integer | the number of tickets to add            |
| event\_id       | integer | the sub\_event id                       |

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

```
[{
	"seat_id": "azL0bNZdD1",
	"seat_row_nr": "0",
	"seat_nr": "0",
	"pmp_name": null,
	"event_id": 95,
	"event_name": "VoordeMensen Demo Event",
	"location_name": "Bellevue Grote Zaal",
	"event_date": "01-04-2022",
	"event_view_end": "00-00-0000",
	"event_time": "20:30",
	"recommand": [],
	"numberoftickets": 1,
	"seat_price": "24.50",
	"category_name": "standaard",
	"discount_id": "2ePdA8q3BN",
	"discount_name": "Standaard"
}, {
	"totalprice": "24.50"
}]
```

{% endtab %}
{% endtabs %}

## Get items in cart

<mark style="color:blue;">`GET`</mark> `https://api.voordemensen.nl/v1/:client_name/cart/:cart_id`

Get a list of items in the cart

#### Path Parameters

| Name         | Type   | Description                                                        |
| ------------ | ------ | ------------------------------------------------------------------ |
| client\_name | string | the short name identifying you as a VdM client e.g. demo or fringe |
| cart\_id     | string | the cart\_id identifying this cart                                 |

{% tabs %}
{% tab title="200 A list of items in the cart, otherwise the response is \[{"cart":0}]" %}

```
[{
	"seat_id": "azL0bNZdD1",
	"seat_row_nr": "0",
	"seat_nr": "0",
	"pmp_name": null,
	"event_id": 95,
	"event_name": "VoordeMensen Demo Event",
	"location_name": "Bellevue Grote Zaal",
	"event_date": "01-04-2022",
	"event_view_end": "00-00-0000",
	"event_time": "20:30",
	"recommand": [],
	"numberoftickets": 1,
	"seat_price": "24.50",
	"category_name": "standaard",
	"discount_id": "2ePdA8q3BN",
	"discount_name": "Standaard"
}, {
	"totalprice": "24.50"
}]
```

{% endtab %}
{% endtabs %}

The response is a list of items in the cart, followed by the calculated total price of the cart.

{% hint style="info" %}
If the Recommendation Extension is activated the response contains an array of other events the user can visit before or after this event, links to those events and even the 🚲cycle-distance between venues.
{% endhint %}

## Delete seat from cart

<mark style="color:red;">`DELETE`</mark> `https://api.voordemensen.nl/v1/:client_name/cart/:cart_id/:seat_id`

Remove a seat from the cart

#### Path Parameters

| Name         | Type   | Description                                                        |
| ------------ | ------ | ------------------------------------------------------------------ |
| seat\_id     | string | the seat\_id identifying the seat to be removed                    |
| cart\_id     | string | the cart\_id identifying this cart                                 |
| client\_name | string | the short name identifying you as a VdM client e.g. demo or fringe |

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

```
```

{% endtab %}
{% endtabs %}


---

# 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://docs.voordemensen.nl/api/public-endpoints/cart.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.