--- title: "PATCH customer" method: PATCH path: "/v3/administrations/{administration_id}/bookings/{booking_id}/customer" tags: ["Booking Customer"] --- # PATCH customer `PATCH /v3/administrations/{administration_id}/bookings/{booking_id}/customer` ## Request - Base URL: `https://api.bookingexperts.com` - URL: `https://api.bookingexperts.com/v3/administrations/{administration_id}/bookings/{booking_id}/customer` - Auth: one of: - API key in header `X-API-KEY` - OAuth 2 - Authorization code: `/oauth/authorize` - Token URL: `/oauth/token` - TypeScript: (a function with typed inputs; its response is checked against the schema) Update customer details of a specific Booking ## Path parameters - `administration_id` string, required - `booking_id` string, required ## Query parameters - `fields[customer]` string - `include` string ## Headers - `Accept-Language` string ## Request body - object - `data` object: Encapsulates the Customer details of a Booking. - `id` string: ID - `type` string: Type - `attributes` object: Attributes - `title` 'mr' | 'ms' | 'family' | 'mrs' | 'miss' | 'mx' | 'dr' | 'prof' | 'rev' | 'sir' | 'dame' | 'lord' | 'lady': The title by which the customer should be addressed. May be left blank. - `first_name` string - `last_name` string - `phone` string - `email` string - `is_company` boolean - `company` string - `vat_nr` string - `business_registration_number` string - `date_of_birth` string, date - `gender` 'male' | 'female' | 'other' | 'prefer_not_to_say' - `receive_newsletter` boolean - `address` string - `number` string - `postalcode` string - `city` string - `country_code` string - `address_subdivision` string - `locale` 'cs' | 'da-DK' | 'de' | 'de-AT' | 'de-CH' | 'en-US' | 'en-GB' | 'es' | 'fr' | 'fr-BE' | 'fr-LU' | 'it' | 'nb' | 'nl' | 'nl-BE' | 'pl' | 'pt' | 'tr' | 'en' | 'da': Locale of customer. Is used for communication. - `iban` string - `bic` string - `has_custom_invoice_details` boolean - `custom_invoice_details` object - `name` string - `address` string - `postalcode` string - `city` string - `country_code` string - `email` string - `relationships` object: Relationships - `labels` object - `data` object[] - `id` string: labels ID - `type` string - `meta` object - `temp_id` string: UUID for internal resource linking of included relationships. Should be omitted when the relationship ID is known. - `method` string: Required when this relationship must be created or updated and is included in the request. Must be omitted when only an association needs to be made with the resource. One of: create, update. - `meta` object: Metadata - `temp_id` string: UUID for internal resource linking. Should be omitted when the relationship ID is known. ## Response `200` CustomerResponse - object - `data` Customer: A Customer is a guest that created one or multiple Bookings. Note that a Customer of a particular Booking may have custom IBAN or BIC details. - `id` string: ID - `type` string: Type - `attributes` object: Attributes - `receive_newsletter` boolean - `title` 'mr' | 'ms' | 'family' | 'mrs' | 'miss' | 'mx' | 'dr' | 'prof' | 'rev' | 'sir' | 'dame' | 'lord' | 'lady': The title by which the customer should be addressed. May be left blank. - `first_name` string - `last_name` string - `phone` string - `email` string - `is_company` boolean - `company` string - `vat_nr` string - `business_registration_number` string - `date_of_birth` string, date - `gender` 'male' | 'female' | 'other' | 'prefer_not_to_say' - `address` string - `number` string - `postalcode` string - `city` string - `country_code` 'AD' | 'AE' | 'AF' | 'AG' | 'AI' | 'AL' | 'AM' | 'AO' | 'AQ' | 'AR' | 'AS' | 'AT' | 'AU' | 'AW' | 'AX' | 'AZ' | 'BA' | 'BB' | 'BD' | 'BE' | 'BF' | 'BG' | 'BH' | 'BI' | 'BJ' | 'BL' | 'BM' | 'BN' | 'BO' | 'BQ' | 'BR' | 'BS' | 'BT' | 'BV' | 'BW' | 'BY' | 'BZ' | 'CA' | 'CC' | 'CD' | 'CF' | 'CG' | 'CH' | 'CI' | 'CK' | 'CL' | 'CM' | 'CN' | 'CO' | 'CR' | 'CU' | 'CV' | 'CW' | 'CX' | 'CY' | 'CZ' | 'DE' | 'DJ' | 'DK' | 'DM' | 'DO' | 'DZ' | 'EC' | 'EE' | 'EG' | 'EH' | 'ER' | 'ES' | 'ET' | 'FI' | 'FJ' | 'FK' | 'FM' | 'FO' | 'FR' | 'GA' | 'GB' | 'GD' | 'GE' | 'GF' | 'GG' | 'GH' | 'GI' | 'GL' | 'GM' | 'GN' | 'GP' | 'GQ' | 'GR' | 'GS' | 'GT' | 'GU' | 'GW' | 'GY' | 'HK' | 'HM' | 'HN' | 'HR' | 'HT' | 'HU' | 'ID' | 'IE' | 'IL' | 'IM' | 'IN' | 'IO' | 'IQ' | 'IR' | 'IS' | 'IT' | 'JE' | 'JM' | 'JO' | 'JP' | 'KE' | 'KG' | 'KH' | 'KI' | 'KM' | 'KN' | 'KP' | 'KR' | 'KW' | 'KY' | 'KZ' | 'LA' | 'LB' | 'LC' | 'LI' | 'LK' | 'LR' | 'LS' | 'LT' | 'LU' | 'LV' | 'LY' | 'MA' | 'MC' | 'MD' | 'ME' | 'MF' | 'MG' | 'MH' | 'MK' | 'ML' | 'MM' | 'MN' | 'MO' | 'MP' | 'MQ' | 'MR' | 'MS' | 'MT' | 'MU' | 'MV' | 'MW' | 'MX' | 'MY' | 'MZ' | 'NA' | 'NC' | 'NE' | 'NF' | 'NG' | 'NI' | 'NL' | 'NO' | 'NP' | 'NR' | 'NU' | 'NZ' | 'OM' | 'PA' | 'PE' | 'PF' | 'PG' | 'PH' | 'PK' | 'PL' | 'PM' | 'PN' | 'PR' | 'PS' | 'PT' | 'PW' | 'PY' | 'QA' | 'RE' | 'RO' | 'RS' | 'RU' | 'RW' | 'SA' | 'SB' | 'SC' | 'SD' | 'SE' | 'SG' | 'SH' | 'SI' | 'SJ' | 'SK' | 'SL' | 'SM' | 'SN' | 'SO' | 'SR' | 'SS' | 'ST' | 'SV' | 'SX' | 'SY' | 'SZ' | 'TC' | 'TD' | 'TF' | 'TG' | 'TH' | 'TJ' | 'TK' | 'TL' | 'TM' | 'TN' | 'TO' | 'TR' | 'TT' | 'TV' | 'TW' | 'TZ' | 'UA' | 'UG' | 'UM' | 'US' | 'UY' | 'UZ' | 'VA' | 'VC' | 'VE' | 'VG' | 'VI' | 'VN' | 'VU' | 'WF' | 'WS' | 'YE' | 'YT' | 'ZA' | 'ZM' | 'ZW' | 'XK' | 'AN' | 'ZZ' | 'WW' - `locale` 'cs' | 'da-DK' | 'de' | 'de-AT' | 'de-CH' | 'en-US' | 'en-GB' | 'es' | 'fr' | 'fr-BE' | 'fr-LU' | 'it' | 'nb' | 'nl' | 'nl-BE' | 'pl' | 'pt' | 'tr' | 'en' | 'da': Locale of customer. Is used for communication. - `debtor_code` string: DEPRECATED Use the debtor_codes instead - `debtor_codes` string[]: The Debtor Codes this customer has within the organization. - `created_at` string, date-time - `updated_at` string, date-time - `relationships` object: Relationships - `labels` object - `data` object[] - `id` string: labels ID - `type` string - `meta` object - `temp_id` string: UUID for internal resource linking of included relationships. Should be omitted when the relationship ID is known. - `method` string: Required when this relationship must be created or updated and is included in the request. Must be omitted when only an association needs to be made with the resource. One of: create, update. - `meta` object: Metadata - `temp_id` string: UUID for internal resource linking. Should be omitted when the relationship ID is known. - `included` Label[] - `id` string: ID - `type` string: Type - `attributes` object: Attributes - `name` string - `background` string: The background color of the label. The foreground color is automatically determined when the label is saved. - `foreground` string: The foreground color of the label. This color is automatically determined based on the background color when updating or creating the label. - `meta` object: Metadata - `temp_id` string: UUID for internal resource linking. Should be omitted when the relationship ID is known. ## Other responses - `429`: Error - `default`: Error ## Changes - **2026-11-03** `ff81bc4fefa9`: 3 warning, 5 info - added the new `da-DK` enum value to the `data/attributes/locale` response property for the response status `200` - added the new `en-GB` enum value to the `data/attributes/locale` response property for the response status `200` - added the new `en-US` enum value to the `data/attributes/locale` response property for the response status `200` - added the new `da-DK` enum value to the request property `data/attributes/locale` - …4 more [Operation history](https://skmtc.dev/bookingexperts/apis/booking-experts-api-v3/changes/v3/administrations/:administration_id/bookings/:booking_id/customer/patch.md) --- [API](https://skmtc.dev/bookingexperts/apis/booking-experts-api-v3.md) - [All operations](https://skmtc.dev/bookingexperts/apis/booking-experts-api-v3/llms.txt) - [OpenAPI document](https://skmtc.dev/bookingexperts/apis/booking-experts-api-v3/revisions/ff81bc4fefa9?raw)