---
title: "Retrieve Cardholder"
method: GET
path: "/v1/issuing/cardholders/{id}"
tags: ["Cardholders"]
---

# Retrieve Cardholder

`GET /v1/issuing/cardholders/{id}`

Retrieves an issuing cardholder object.

## Path parameters

- `id` string, uuid, required

## Headers

- `x-on-behalf-of` string

## Response `200`

OK - Successfully retrieved a cardholder.

- CardholderListResponse
  - `cardholder_id` string, uuid — The cardholder's unique identifier.
  - `email` string — The cardholder's email address.
  - `number_of_cards` integer — The total number of cards associated with the cardholder, including all statuses.
  - `first_name` string — The first name of this cardholder. Required before activating Cards. This field cannot contain any numbers, special characters (except periods, commas, hyphens, spaces and apostrophes) or non-latin letters.
  - `last_name` string — The last name of this cardholder. Required before activating Cards. This field cannot contain any numbers, special characters (except periods, commas, hyphens, spaces and apostrophes) or non-latin letters.
  - `create_time` string — Time at which the object was created.
  - `cardholder_status` 'FAILED' | 'PENDING' | 'SUCCESS' | 'INCOMPLETE' — The cardholder's status.
  - `date_of_birth` string — The cardholder's birth date with `yyyy-mm-dd` format.
  - `country_code` string — Two-letter country code [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
  - `phone_number` string — The cardholder's phone number. See [Phone number validation rules](/card-issuance/v1.6/guide/phone-number-validation-rules-for-cardholder) for length validation details.
  - `gender` 'MALE' | 'FEMALE' — The cardholder's gender. * `MALE` - Male. * `FEMALE` - Female.
  - `nationality` string — The cardholder's nationality in ISO 3166-1 alpha-2 format. Required for STANDARD and ENHANCED KYC levels.
  - `residential_address` ResidentialAddress — The cardholder's residential address. All fields accept only letters (A-Z, a-z), digits (0-9), spaces, and the following punctuation: `, . ' / # ( ) - &`. Requests containing any other character are rejected — correct the value and resubmit. Empty optional fields are not validated.
    - `country` string, required — Two-letter country code [ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).
    - `state` string — State, county, province, or region.
    - `city` string, required — City, district, suburb, town, or village.
    - `district` string — District or sub-region within the city.
    - `line1` string, required — Address line 1 (e.g., street, PO Box, or company name).
    - `line2` string — Address line 2 (e.g., apartment, suite, unit, or building).
    - `line_en` string — Address in English.
    - `postal_code` string — ZIP or postal code. If you intend to issue an Enhanced card, this field must be 4-10 characters long.
  - `review_status` 'SUCCESS' | 'FAILED' | 'PENDING' — The review status of the cardholder.
  - `idv_status` 'PENDING' | 'PASSED' | 'FAILED' — IDV verification status. Returned when applicable. * `PENDING` - IDV pending. * `PASSED` - IDV passed. * `FAILED` - IDV failed.
  - `idv_verification_url` string — IDV verification URL. Returned when applicable.
  - `idv_url_expires_at` string — IDV verification URL expiration time in RFC 3339 format.

---

[API](https://skmtc.dev/uqpay/apis/authentication-api.md) · [All operations](https://skmtc.dev/uqpay/apis/authentication-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/uqpay/authentication-api/revisions/cef532a10777/schema)