# Update a cardholder

Updates the specified Issuing `Cardholder` object by setting the values of the parameters passed. Any parameters not provided will be left unchanged.

## Prerequisites

Before you can run the following code snippet, you need to call these APIs with the provided parameters to set up the prerequisite API object(s).

1. createIssuingCardholder
POST /v1/issuing/cardholders {"type":"individual","name":"Jenny Rosen","email":"jenny.rosen@example.com","phone_number":"+18888675309","billing":{"address":{"line1":"1234 Main Street","city":"San Francisco","state":"CA","country":"US","postal_code":"94111"}}}

## Request

```curl
curl https://api.stripe.com/v1/issuing/cardholders/{{CARDHOLDER_ID}} \
  -u "<<YOUR_SECRET_KEY>>:" \
  -H "Stripe-Version: 2025-11-17.preview" \
  -d "metadata[order_id]"=6735
```

### Response

```json
{
  "id": "ich_1MsKAB2eZvKYlo2C3eZ2BdvK",
  "object": "issuing.cardholder",
  "billing": {
    "address": {
      "line1": "1234 Main Street",
      "city": "San Francisco",
      "state": "CA",
      "country": "US",
      "postal_code": "94111"
    }
  },
  "company": null,
  "created": 1680415995,
  "email": "jenny.rosen@example.com",
  "individual": null,
  "livemode": false,
  "metadata": {
    "order_id": "6735"
  },
  "name": "Jenny Rosen",
  "phone_number": "+18888675309",
  "redaction": null,
  "requirements": {
    "disabled_reason": "requirements.past_due",
    "past_due": [
      "individual.card_issuing.user_terms_acceptance.ip",
      "individual.card_issuing.user_terms_acceptance.date",
      "individual.first_name",
      "individual.last_name"
    ]
  },
  "spending_controls": {
    "allowed_categories": [],
    "blocked_categories": [],
    "spending_limits": [],
    "spending_limits_currency": null
  },
  "status": "active",
  "type": "individual"
}
```

## Returns

Returns an updated Issuing `Cardholder` object if a valid identifier was provided.

## Parameters

- [`billing`](https://docs.stripe.com/api/issuing/cardholders/update.md?query=billing&api-version=2025-11-17.preview) (object, optional)
  The cardholder’s billing address.

- [`company`](https://docs.stripe.com/api/issuing/cardholders/update.md?query=company&api-version=2025-11-17.preview) (object, optional)
  Additional information about a `company` cardholder.

- `email` (string, optional)
  The cardholder’s email address.

  The maximum length is 800 characters.

- [`individual`](https://docs.stripe.com/api/issuing/cardholders/update.md?query=individual&api-version=2025-11-17.preview) (object, optional)
  Additional information about an `individual` cardholder.

- `metadata` (object, optional)
  Set of [key-value pairs](https://docs.stripe.com/docs/api/metadata.md?api-version=2025-11-17.preview) that you can attach to an object. This can be useful for storing additional information about the object in a structured format. Individual keys can be unset by posting an empty value to them. All keys can be unset by posting an empty value to `metadata`.

- `phone_number` (string, optional)
  The cardholder’s phone number. This is required for all cardholders who will be creating EU cards. See the [3D Secure documentation](https://docs.stripe.com/docs/issuing/3d-secure.md?api-version=2025-11-17.preview) for more details.

- `preferred_locales` (array of enums, optional)
  The cardholder’s preferred locales (languages), ordered by preference. Locales can be `de`, `en`, `es`, `fr`, or `it`. This changes the language of the [3D Secure flow](https://docs.stripe.com/docs/issuing/3d-secure.md?api-version=2025-11-17.preview) and one-time password messages sent to the cardholder.

- [`spending_controls`](https://docs.stripe.com/api/issuing/cardholders/update.md?query=spending_controls&api-version=2025-11-17.preview) (object, optional)
  Rules that control spending across this cardholder’s cards. Refer to our [documentation](https://docs.stripe.com/docs/issuing/controls/spending-controls.md?api-version=2025-11-17.preview) for more details.

- `status` (enum, optional)
  Specifies whether to permit authorizations on this cardholder’s cards.
Possible enum values:
  - `active`
    Cards attached to this cardholder can approve authorizations.

  - `inactive`
    Cards attached to this cardholder will decline all authorizations with a `cardholder_inactive` reason.
