---
uuid: 5678d4b3-a96e-4e00-a3f4-9f0d76de47c4
date_created: 2026-02-27T06:19:33.946Z
date_updated: 2026-04-03T08:26:30.242Z
seo_url: save-and-consult-customer-search-criteria
category: Booking
tags: 
  - Customers
  - User personalization
routes: 
  - POST /v0/customers/{customer_id}/bookmarks
  - GET /v0/customers/{customer_id}/bookmarks
---

# Save and consult customer search criteria

This scenario explains how to save a set of search criteria in a customer account and retrieve it later to restart a search from stored preferences.

## Flow

```mermaid
flowchart LR
    step0["Save search criteria"]
    step1["Consult saved search criteria"]
    step0 --> step1
```

## Overview

Use `POST /v0/customers/{customer_id}/bookmarks` to persist saved searches and `GET /v0/customers/{customer_id}/bookmarks` to reload them from the customer space.

## Prerequisites

* `customer_id` must refer to an existing customer account.
* Customer bookmark routes require the customer scope to be available.
* `accept-language` and `x-api-key` are required on the documented calls.

## 1 - Save search criteria

Use `POST /v0/customers/{customer_id}/bookmarks` to persist a saved search in the customer account so the stay criteria can be reused in a later journey.

#### Prerequisites

* Header `accept-language`
* Header `authorization`
* Header `x-api-key`
* Path `customer_id`
* The route expects a request body, but the detailed body schema is not visible in the available contract excerpt. The payload must carry the criteria to save, such as the targeted product and stay context.

#### Calling CURL

```bash
curl -X POST "https://api.clubmed.com/v0/customers/123456789/bookmarks" \
  -H "accept-language: en-US" \
  -H "authorization: Bearer <token>" \
  -H "x-api-key: <your-api-key>" \
  -H "Content-Type: application/json"
```

#### Example answer

```text
HTTP/1.1 201 Created
```

> **info:** The detailed response body is not exposed in the available contract excerpt. Use this step when you need a durable account-level bookmark rather than a temporary front-end state.

***

**Response codes**

* `201`: bookmark saved successfully.
* `400`: bad request, validation error or invalid JSON payload.
* `401`: unauthorized.
* `403`: customer mismatch or issuer mismatch.

**Related route**: [POST https://api.clubmed.com//v0/customers/{customer\_id}/bookmarks](https://api.clubmed.com/doc?search=POST%20%2Fv0%2Fcustomers%2F%7Bcustomer_id%7D%2Fbookmarks)

## 2 - Consult saved search criteria

Use `GET /v0/customers/{customer_id}/bookmarks` to retrieve the searches previously saved in the customer account and display them in a follow-up journey.

#### Prerequisites

* Header `accept-language`
* Header `authorization`
* Header `x-api-key`
* Path `customer_id`

#### Calling CURL

```bash
curl --get "https://api.clubmed.com/v0/customers/123456789/bookmarks" \
  -H "accept-language: en-US" \
  -H "authorization: Bearer <token>" \
  -H "x-api-key: <your-api-key>"
```

#### Example answer

```json
[
  {
    "id": "1",
    "product_id": "MPAC",
    "resort_arrival_date": "20260117",
    "resort_departure_date": "20260117",
    "number_attendees": 2,
    "departure_option_id": "PAR",
    "price": {
      "amount": 80,
      "currency": "EUR"
    }
  }
]
```

> **info:** Reuse the returned bookmark `id` and stay criteria to rebuild a saved search card or reopen the product selection in the exact same context.

***

**Response codes**

* `200`: saved searches returned successfully.
* `400`: bad request or validation error.
* `401`: unauthorized.
* `403`: customer mismatch or issuer mismatch.

**Related route**: [GET https://api.clubmed.com//v0/customers/{customer\_id}/bookmarks](https://api.clubmed.com/doc?search=GET%20%2Fv0%2Fcustomers%2F%7Bcustomer_id%7D%2Fbookmarks)