---
title: "Get cardholder details"
method: GET
path: "/issuing/cardholders/{cardholderId}"
tags: ["Cardholders"]
---

# Get cardholder details

`GET /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-read`
- TypeScript: <https://skmtc.dev/checkout/apis/checkout-com-api-reference/docs/issuing/cardholders/:cardholderId/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve the details for a cardholder you created previously.

## Path parameters

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

## Response `200`

Cardholder retrieved successfully

- GetCardholderResponse
  - `id` string, required: The cardholder's unique identifier.
  - `type` string, required: The cardholder type. Currently `individual` is the only supported value.
  - `first_name` string, required: The cardholder's first name.
  - `middle_name` string: The cardholder's middle name.
  - `last_name` string, required: The cardholder's last name.
  - `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.
  - `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.
  - `date_of_birth` string, date: The cardholder's date of birth. <br/>Format – `YYYY-MM-DD`
  - `billing_address` IssuingAddress, required
    - `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>.
  - `reference` string: Your reference.
  - `client_id` string, required: The client's unique identifier.
  - `account_entity_id` string: The entity's unique identifier.
  - `parent_sub_entity_id` string: The entity's unique identifier.
  - `entity_id` string, required: The entity's unique identifier.
  - `status` 'active' | 'pending' | 'restricted' | 'requirements_due' | 'inactive' | 'rejected' | 'draft' | 'suspended': The cardholder's status.
  - `created_date` string, date-time
  - `last_modified_date` string, date-time
  - `_links` IssuingCardholderLinks: 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
    - `cards` IssuingLink
      - `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
- `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)