# The Cardholder object

### The Cardholder object

```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": {},
  "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"
}
```

## Attributes

- `id` (string)
  Unique identifier for the object.

- `object` (string)
  String representing the object’s type. Objects of the same type share the same value.

- [`billing`](https://docs.stripe.com/api/issuing/cardholders/object.md?query=billing) (object)
  The cardholder’s billing information.

- [`company`](https://docs.stripe.com/api/issuing/cardholders/object.md?query=company) (object, nullable)
  Additional information about a `company` cardholder.

- `created` (timestamp)
  Time at which the object was created. Measured in seconds since the Unix epoch.

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

- [`individual`](https://docs.stripe.com/api/issuing/cardholders/object.md?query=individual) (object, nullable)
  Additional information about an `individual` cardholder.

- `livemode` (boolean)
  If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.

- `metadata` (map)
  Set of [key-value pairs](https://docs.stripe.com/api/metadata.md) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.

- `name` (string)
  The cardholder’s name. This will be printed on cards issued to them.

- `phone_number` (string, nullable)
  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/issuing/3d-secure.md#when-is-3d-secure-applied) for more details.

- `preferred_locales` (array of enums, nullable)
  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/issuing/3d-secure.md) and one-time password messages sent to the cardholder.

- [`requirements`](https://docs.stripe.com/api/issuing/cardholders/object.md?query=requirements) (object)
  Information about verification requirements for the cardholder.

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

- `status` (enum)
  Specifies whether to permit authorizations on this cardholder’s cards.
Possible enum values:
  - `active`
    A platform has enabled the cardholder to approve authorizations made with their attached cards. However, if Stripe hasn’t yet verified the cardholder’s identity information, authorizations might still be blocked.

  - `blocked`
    Cards attached to this cardholder will decline all authorizations with the `cardholder_blocked` reason. This status is non-reversible.

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

- `type` (enum)
  One of `individual` or `company`. See [Choose a cardholder type](https://docs.stripe.com/issuing/other/choose-cardholder.md) for more details.
Possible enum values:
  - `company`
    The cardholder is a company or business entity, and additional information includes their tax ID. This option may not be available if your [use case](https://docs.stripe.com/issuing/other/choose-cardholder.md#find-your-use-case) only supports individual cardholders.

  - `individual`
    The cardholder is a person, and additional information includes first and last name, date of birth, etc. If you’re issuing Celtic Spend Cards, then Individual cardholders must accept Authorized User Terms prior to activating their card.