customers

customer's bookings list

Provide the list of all bookings of a customer: past, present and future for all statuses.<br> The following filters can be applied:<br> filters on the "period" (PASTS, CURRENTS, FUTURS). The period is based on the booking end date.<br> filters on the "booking_status" (VALIDATED, OPTION)<br>

get/v3/customers/{customer_id}/bookings

Request

  • Base URL: https://api.clubmed.com
  • URL: https://api.clubmed.com/v3/customers/{customer_id}/bookings
  • Auth: one of:
    • OpenID Connect (https://accounts.clubmed.com/.well-known/openid-configuration, scopes: openid, email, profile, clubmed)
    • OpenID Connect (https://auth.clubmed.com/.well-known/openid-configuration, scopes: openid, email, profile, clubmed)

Path parameters

customer_idstring required

Customer ID (neolid clic)

Example:123456789

Query parameters

period'PASTS' | 'CURRENTS' | 'FUTURS'

The period is based on the booking end date

booking_statusstring

The status of the booking: VALIDATED, CANCELED, QUOTATION, OPTION, HOPE, EXPIRED_OPTION, REQUEST. For multiple criterion, separate with comma and without space: "VALIDATED,OPTION"

min_creation_datestring date

minimum creation date of the booking Supported formats: YYYY-MM-DD, YYYYMMDD Supported formats: YYYY-MM-DD, YYYYMMDD, YYYYMM

Example:2022-04-15
max_creation_datestring date

maximum creation date of the booking Supported formats: YYYY-MM-DD, YYYYMMDD Supported formats: YYYY-MM-DD, YYYYMMDD, YYYYMM

Example:2022-04-15
discount_idstring

Discount that must be present in the booking

sortstring

Bookings sorting : ASC returns oldest bookings first, DESC returns newest bookings first (default: ASC). Use departure_date:ASC OR departure_date:DESC to sort

Example:best_price.per_trip:asc
pageinteger

Requested page number, starting from 1 (default: 1)

limitinteger

max number of bookings by page (default: 10)

Headers

accept-language'fr-FR' | 'fr-BE' | 'nl-BE' | 'de-CH' | 'fr-CH' | 'en-CH' | 'nl-NL' | 'de-DE' | 'en-IL' | 'he-IL' | 'it-IT' | 'en-SE' | 'pt-PT' | 'en-ZA' | 'es-ES' | 'en-GB' | 'en-CY' | 'tr-TR' | 'ru-RU' | 'uk-UA' | 'en-DK' | 'en-FI' | 'en-NO' | 'en-IE' | 'en-US' | 'es-MX' | 'fr-CA' | 'en-CA' | 'es-PA' | 'es-AR' | 'es-CL' | 'pt-BR' | 'es-CO' | 'es-PE' | 'es-VE' | 'es-UY' | 'en-CN' | 'zh-CN' | 'zh-TW' | 'en-TW' | 'en-HK' | 'zh-HK' | 'en-AU' | 'en-ID' | 'id-ID' | 'en-IN' | 'ja-JP' | 'ko-KR' | 'en-MY' | 'en-NZ' | 'en-SG' | 'en-TH' | 'vn-VN' | 'de-AT' | 'ro-RO' | 'pl-PL' | 'et-EE' | 'lv-LV' | 'en-LB' | 'fr-MA' | 'se-SE' | 'th-TH' | 'en-JP' | 'en-AF' | 'en-AL' | 'fr-DZ' | 'fr-AD' | 'en-AO' | 'en-AG' | 'en-SA' | 'en-AM' | 'en-BS' | 'en-BH' | 'en-BD' | 'en-BB' | 'en-BZ' | 'en-BJ' | 'en-BM' | 'en-BT' | 'en-MM' | 'es-BO' | 'es-BW' | 'en-BN' | 'en-BG' | 'en-BI' | 'en-BF' | 'en-CM' | 'fr-CV' | 'en-KY' | 'fr-CF' | 'en-SH' | 'en-CO' | 'en-KM' | 'fr-CG' | 'en-KR' | 'en-KP' | 'en-CR' | 'fr-CI' | 'en-CU' | 'en-DJ' | 'en-DO' | 'en-DM' | 'en-EG' | 'en-SV' | 'en-AE' | 'en-EC' | 'fr-ET' | 'en-FJ' | 'en-GA' | 'en-GM' | 'en-GH' | 'en-GI' | 'gr-GR' | 'en-GD' | 'en-GT' | 'en-GN' | 'fr-GW' | 'en-GQ' | 'en-GY' | 'fr-GP' | 'fr-GF' | 'en-HT' | 'en-HN' | 'en-HU' | 'fr-IQ' | 'en-IR' | 'en-IS' | 'fr-TL' | 'en-JM' | 'en-JO' | 'en-KZ' | 'en-KH' | 'en-KE' | 'fr-KI' | 'en-KW' | 'en-LA' | 'fr-LS' | 'en-LR' | 'en-LY' | 'en-LI' | 'fr-LU' | 'en-MO' | 'en-MG' | 'en-MW' | 'en-MV' | 'en-ML' | 'en-MT' | 'ma-MA' | 'en-MU' | 'en-MR' | 'en-YT' | 'fr-MC' | 'en-MN' | 'fr-MQ' | 'en-MZ' | 'en-MD' | 'fr-PS' | 'en-NA' | 'fr-NR' | 'en-NP' | 'en-NI' | 'en-NE' | 'en-NG' | 'en-NC' | 'fr-CK' | 'en-OM' | 'en-UG' | 'en-PK' | 'en-PA' | 'en-PG' | 'es-PY' | 'en-PH' | 'fr-PN' | 'fr-PF' | 'en-PR' | 'en-QA' | 'en-RW' | 'fr-RE' | 'fr-BL' | 'en-KN' | 'en-MF' | 'en-LC' | 'en-SM' | 'fr-PM' | 'fr-VC' | 'fr-SB' | 'en-WS' | 'fr-ST' | 'en-SN' | 'en-SC' | 'fr-SL' | 'fr-SO' | 'fr-SD' | 'en-LK' | 'en-SR' | 'en-SZ' | 'en-SY' | 'en-TZ' | 'en-TD' | 'en-CZ' | 'fr-IO' | 'fr-TF' | 'en-TG' | 'fr-TO' | 'en-TT' | 'tu-TN' | 'en-TC' | 'fr-TV' | 'fr-LB' | 'en-VU' | 'fr-VA' | 'en-VG' | 'en-VN' | 'en-WF' | 'en-YE' | 'fr-YE' | 'en-RS' | 'fr-CD' | 'fr-ZM' | 'en-ZW' | 'fr-ME' | 'fr-FM' | 'fr-MH' | 'fr-PW' | 'en-HR' | 'en-SI' | 'en-SK' | 'en-EE' | 'en-LT' | 'en-LV' | 'en-MK' | 'en-BA' | 'en-UZ' | 'en-BY' | 'fr-TJ' | 'en-GE' | 'en-AZ' | 'es-DO' | 'fr-TM' | 'fr-TN' | 'sk-SK' required

Language/Country, as returned by <code>GET /v0/locales</code> ; e.g. "en-US", "fr-FR", "ja-JP"

Example:fr-FR
authorizationstring required

Optional Access Token (bearer)

Example:Bearer aaaa.vbbbB.bbbb

Access Token (bearer)

x-api-keystring required

Api_key provided by ClubMed API team

Response

ok

idstring required

booking id

creation_datestring date nullable

booking creation date, YYYYMMDD

departure_datestring date

booking departure date: date of first outward flight if transport, date of arrival in first stay if not. YYYYMMDD

return_datestring date nullable

booking return date: date of last return flight if transport, date of departure of last stay if not. YYYYMMDD

multiple_sale_contractsboolean nullable required

true if the booking is composed of mulitple sales contracts, owned by different customers. Online sale processes are not possible in this case.

booking_status'OPTION' | 'CANCELED' | 'VALIDATED' | 'PARTIALLY_VALIDATED' | 'EXPIRED' | 'UNKNOWN' | 'PENDING_PAYMENT' | 'MUTE' | 'EXPIRED_OPTION' | 'QUOTATION' | 'HOPE' | 'EXPIRED_HOPE' | 'EXPIRED_QUOTATION' | 'REQUEST' | 'ARCHIVED'

booking's status

is_renewed_optionboolean nullable

Deprecated - Indicates if an option has been renewed or not

payment_status'PAID' | 'UNPAID' | 'IN_CREDIT' | 'PENDING' | 'UNKNOWN'

booking payment's status

allowed_to_payboolean nullable

defines if GM's payment is allowed for an agency

localestring nullable

Language/Country the booking has been created with

Changes

No recorded changes to this operation across all 1 revision of this API.