--- title: "Update Cardholder" method: PATCH path: "/cardholders/{cardholderId}" tags: ["Cardholders"] --- # Update Cardholder `PATCH /cardholders/{cardholderId}` Updates [cardholder](/docs/cardholder-entity) details. ## Path parameters - `cardholderId` string, uuid, required ## Query parameters - `organizationId` string, uuid, required ## Request body - object - `salutation` 'MR' | 'MRS' — Used mainly for email communication. - `firstName` string, required — The first name of the cardholder. This will be printed on credit cards as the cardholder. It is important to note, that only the following characters are allowed for issuing cards: `A-Z`, `a-z`, `0-9`, `äöüÄÖÜ.-` Maximum length of the combination of first name and last name must not be more then 25 digits (to ensure its correctly displayed on the cards). - `lastName` string, required — The last name of the cardholder. This will be printed on credit cards as the cardholder. It is important to note, that only the following characters are allowed for issuing cards: `A-Z`, `a-z`, `0-9`, `äöüÄÖÜ.-` Maximum length of the combination of first name and last name must not be more then 25 digits (to ensure its correctly displayed on the cards). - `email` string, required — The email address of the cardholder. This will be used for email communication. If the email address is updated for [cardholder](/docs/cardholder-entity) that has been invited via API or Pliant apps, an email notification is triggered. - `phoneNumber` string, required — The phone number must start with `+` followed by 8 to 15 numbers, e.g. `+49123456789`. If the phone number of a [cardholder](/docs/cardholder-entity) is updated, who was invited via Pliant and not the API, the phone number is not changed immediately, but the [cardholder](/docs/cardholder-entity) will receive an email instead with instructions to re-login to Pliant's web app and to update the phone number there. This is necessary as a security precaution, since the phone number is a critical part of the 3DS authentication process for handling purchases with a credit card. - `language` 'en' | 'de' | 'es' | 'fi' | 'fr' | 'it' | 'pt' | 'nl' | 'et' | 'el' | 'lv' | 'lt' | 'sk' | 'sl' | 'pl', required — Used for setting the language in Pliant apps as well as for email communication. - `isOwner` boolean — If `true`, the [cardholder](/docs/cardholder-entity) is the owner of the organization. The owner is allowed to administer all settings of the organization on the Pliant platform. If `false`, the [cardholder](/docs/cardholder-entity) is a plain [cardholder](/docs/cardholder-entity) with limited rights on the Pliant platform. Only works if [cardholder](/docs/cardholder-entity) was invited via API or Pliant apps. - `dateOfBirth` string, date, nullable — The date-of-birth of the cardholder. Depending on the compliance configuration of your payment program, this field may be required. Omitting it in those cases will result in a 400 Bad Request. - `nationality` string, nullable — The nationality of the cardholder (ISO 3166-1 alpha-2). Depending on the compliance configuration of your payment program, this field may be required. Omitting it in those cases will result in a 400 Bad Request. - `personalAddress` object, nullable — The personal address of the cardholder. - `country` string, nullable — The country of the address in ISO 3166-1 alpha-2 notation. - `city` string, nullable — The city of the address. - `postalCode` string, nullable — The postal code of the address. Must match the country-specific format (e.g. 5 digits for `DE`/`FR`/`ES`, 4 digits for `AT`/`BE`). Both `postalCode` and `country` must be provided together. - `streetName` string, nullable — The street name of the address. - `streetNumber` string, nullable — The street number of the address. - `additionalInformation` string, nullable — Optional additional address information. - `deliveryAddress` object, nullable — The delivery address of the cardholder. - `country` string, nullable — The country of the address in ISO 3166-1 alpha-2 notation. - `city` string, nullable — The city of the address. - `postalCode` string, nullable — The postal code of the address. Must match the country-specific format (e.g. 5 digits for `DE`/`FR`/`ES`, 4 digits for `AT`/`BE`). Both `postalCode` and `country` must be provided together. - `streetName` string, nullable — The street name of the address. - `streetNumber` string, nullable — The street number of the address. - `additionalInformation` string, nullable — Optional additional address information. ## Response `200` Cardholder successfully updated. - object - `cardholderId` string, uuid — The unique identifier of the [cardholder](/docs/cardholder-entity). - `salutation` 'MR' | 'MRS', nullable — The salutation of the cardholder. Mainly used for email communication. - `firstName` string — The first name of the cardholder. This will be printed on credit cards as the cardholder. It is important to note, that only the following characters are allowed for issuing cards: `A-Z`, `a-z`, `0-9`, `äöüÄÖÜ.-` Maximum length of the combination of first name and last name must not be more then 25 digits (to ensure its correctly displayed on the cards). - `lastName` string — The last name of the cardholder. This will be printed on credit cards as the cardholder. It is important to note, that only the following characters are allowed for issuing cards: `A-Z`, `a-z`, `0-9`, `äöüÄÖÜ.-` Maximum length of the combination of first name and last name must not be more then 25 digits (to ensure its correctly displayed on the cards). - `email` string — The email address of the cardholder. This will be used for email communication. - `phoneNumber` string — Phone number must start with `+` followed by 8 to 15 numbers, e.g. `+49123456789`. Important! When changing the phone number, the new phone number must be verified by the cardholder within Pliant, if the cardholder has access to Pliant web app. If the cardholder has no access to Pliant, the phone number is changed without an additional verification, but with a short delay of some seconds. You will receive a callback once the cardholder is fully updated. - `language` 'en' | 'de' | 'es' | 'fi' | 'fr' | 'it' | 'pt' | 'nl' | 'et' | 'el' | 'lv' | 'lt' | 'sk' | 'sl' | 'pl' — Used for setting the language in Pliant apps as well as for email communication. - `eligibleForPlatformFeeCards` boolean — Describes if the cardholder is eligible to have [platform fee cards](/reference/reassign-platform-fee-card) assigned to them. Note, that this field depends on the organization. The combination of `cardholderId` and `organizationId` defines if this field is `true` or `false`. - `isOwner` boolean — If `true`, the [cardholder](/docs/cardholder-entity) is the owner of the organization. The owner is allowed to administer all settings of the organization on the Pliant platform. If `false`, the [cardholder](/docs/cardholder-entity) is a plain [cardholder](/docs/cardholder-entity) with limited rights on the Pliant platform. - `status` 'INVITED' | 'ACTIVE' | 'DEACTIVATED' — The status of the cardholder. - `isEmbedded` boolean — Describes if the [cardholder](/docs/cardholder-entity) is embedded with a partner and thus can only be managed via the API. If `true`, it can only be managed via API, if `false`, if can be managed via UI as well and the [cardholder](/docs/cardholder-entity) can also log into Pliant web app. - `dateOfBirth` string, date, nullable — The date-of-birth of the cardholder. - `nationality` string, nullable — The nationality of the cardholder (ISO 3166-1 alpha-2). - `personalAddress` object, nullable — The personal address of the cardholder. - `country` string, nullable — The country of the address in ISO 3166-1 alpha-2 notation. - `city` string, nullable — The city of the address. - `postalCode` string, nullable — The postal code of the address. - `streetName` string, nullable — The street name of the address. - `streetNumber` string, nullable — The street number of the address. - `additionalInformation` string, nullable — Optional additional address information. - `deliveryAddress` object, nullable — The delivery address of the cardholder. - `country` string, nullable — The country of the address in ISO 3166-1 alpha-2 notation. - `city` string, nullable — The city of the address. - `postalCode` string, nullable — The postal code of the address. - `streetName` string, nullable — The street name of the address. - `streetNumber` string, nullable — The street number of the address. - `additionalInformation` string, nullable — Optional additional address information. ## Other responses - `400` — unresolved $ref - `401` — unresolved $ref - `403` — unresolved $ref - `404` — unresolved $ref - `500` — unresolved $ref --- [API](https://skmtc.dev/getpliant/apis/pliant-customer-api.md) · [All operations](https://skmtc.dev/getpliant/apis/pliant-customer-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/getpliant/pliant-customer-api/revisions/f3f589cfa718/schema)