---
uuid: 8a5f944a-b2f8-42ba-8e4a-e12cb4f5df76
date_created: 2025-12-11T10:17:38.325Z
date_updated: 2026-04-03T17:04:02.452Z
seo_url: retrieve-customer-eligible-promotions
category: Payment
tags: 
  - Customers
routes: 
  - GET /v2/customers/{customer_id}/commercial_offers
---

# Retrieve a customer's eligible promotions

This route retrieves all the promotions a client is eligible for.

It only requires a client's ID and returns all available promotions for that client in response.

Promotions can belong to different categories, including:

* Credit notes (CREDIT\_NOTE)
* Sponsorship (SPONSORSHIP)
* Targeted offers (TARGETED\_OFFER)
* Refunds (REFUND)

## Flow

false

## Overview

Use this scenario to retrieve the promotions or commercial benefits available for a given customer account. The response can feed a customer area, a seller cockpit, or a quotation flow that needs eligible offers before pricing.

## Prerequisites

* Have a valid `customer_id`.
* Send `authorization`, `x-api-key`, and `accept-language` when your integration context requires them.

## 1 - Retrieve a customer's commercial offers

This route returns the commercial offers available for a given customer.

#### Prerequisites

Use `customer_id` with a valid authorization token. Add `date_format` if you need a specific date format in the response.

#### Calling CURL

```bash
curl -X GET \
  -H "x-api-key: $API_KEY" \
  -H "accept-language: en-US" \
  -H "Authorization: Bearer $ACCESS_TOKEN" \
  "https://api.clubmed.com/v2/customers/{customer_id}/commercial_offers?date_format=Y-m-d"
```

#### Example answer

```json
[
  {
    "id": "offer-1",
    "type": "PROMOTION",
    "offer_id": "PROMO2026",
    "label": "Summer Promo",
    "code": "SUMMER",
    "value": 10,
    "unit": "PERCENT",
    "currency": "EUR",
    "status": "ACTIVE"
  }
]
```

> **info:** The response can be used to display eligible promotions or prepare a personalized proposal.

***

**Response codes**

* `200 OK`: the commercial offers are returned.
* `400 Bad Request`: invalid parameters.
* `401 Unauthorized`: missing or invalid token.
* `403 Forbidden`: the customer is not accessible in this context.

**Related route**: [GET https://api.clubmed.com//v2/customers/{customer\_id}/commercial\_offers](https://api.clubmed.com/doc?search=GET%20%2Fv2%2Fcustomers%2F%7Bcustomer_id%7D%2Fcommercial_offers)