---
title: "Update a cardholder"
method: PATCH
path: "/issuing/cardholders/{cardholderId}"
tags: ["Cardholders"]
---

# Update a cardholder

`PATCH /issuing/cardholders/{cardholderId}`

## Request

- Base URL: `https://{prefix}.api.sandbox.checkout.com`
- URL: `https://{prefix}.api.sandbox.checkout.com/issuing/cardholders/{cardholderId}`
- Auth: OAuth 2
  - Client credentials
  - Token URL: `string` scopes: `issuing:card-management-write`
- TypeScript: <https://skmtc.dev/checkout/apis/checkout-com-api-reference/docs/issuing/cardholders/:cardholderId/patch.ts> (a function with typed inputs; its response is checked against the schema)

Updates the details of an existing cardholder.

## Path parameters

- `cardholderId` string, required: The cardholder's unique identifier.

## Request body

- UpdateCardholderRequest: The cardholder's fields to update.
  - `first_name` string: The cardholder's first name.
  - `middle_name` string: The cardholder's middle name. To set this field to null, pass `null` in your request.
  - `last_name` string: The cardholder's last name.
  - `date_of_birth` string, date: The cardholder's date of birth in the YYYY-MM-DD format. To set this field to null, pass `null` in your request.
  - `phone_number` IssuingPhoneNumber: The cardholder's mobile phone number. This is used in the card tokenization one-time passcode (OTP) challenge flow and in delivery details for physical cards.
    - `country_code` string: The international <a href="https://docs.checkout.com/resources/codes/country-codes" target="blank">country calling code</a>.
    - `number` string: A valid phone number without leading zeros.
  - `email` string, email: The cardholder's email address. Emails are validated against the <a href="https://datatracker.ietf.org/doc/html/rfc6530">rfc6530</a> standard.
  - `billing_address` IssuingAddress
    - `address_line1` string, required: The first line of the address.
    - `address_line2` string: The second line of the address.
    - `city` string, required: The address city.
    - `state` string: The address state.
    - `zip` string, required: The address zip code, or postal code.
    - `country` string, required: The address country, as an <a href="https://www.checkout.com/docs/resources/codes/country-codes" target="blank">ISO country code</a>.
  - `residency_address` IssuingAddress
    - `address_line1` string, required: The first line of the address.
    - `address_line2` string: The second line of the address.
    - `city` string, required: The address city.
    - `state` string: The address state.
    - `zip` string, required: The address zip code, or postal code.
    - `country` string, required: The address country, as an <a href="https://www.checkout.com/docs/resources/codes/country-codes" target="blank">ISO country code</a>.

## Response `200`

Cardholder updated successfully

- UpdateCardholderResponse
  - `last_modified_date` string, date-time, required
  - `_links` IssuingUpdateCardholderLinks, required: The links related to the current cardholder.
    - `self` IssuingLink, required
      - `href` string, required: The link URL.
      - `actions` string[], required: The HTTP Methods that can be performed on the link.
      - `types` string[], required: The Content Types for the link to the resource

## Other responses

- `401`: Unauthorized
- `404`: Cardholder not found
- `422`: Invalid data was sent
- `500`: Internal Server Error

---

[API](https://skmtc.dev/checkout/apis/checkout-com-api-reference.md) - [All operations](https://skmtc.dev/checkout/apis/checkout-com-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/checkout/apis/checkout-com-api-reference/revisions/0f1abdb1c3e9?raw)