> ## Documentation Index
> Fetch the complete documentation index at: https://docs-payment-merchant.keysecure.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Cardholder Details

Retrieves cardholder details, including accounts and the list of successfully issued cards.

## Request Headers

<ParamField header="Api-Key" type="string" required placeholder="your_api_key">
  apiKey (merchant credential, bound to IP whitelist)
</ParamField>

<ParamField header="Timestamp" type="string" required>
  Unix timestamp in milliseconds. The deviation from the server time must be within 60 seconds, and future timestamps are not accepted.
</ParamField>

<ParamField header="Access-Token" type="string" required placeholder="your_access_token">
  Login token (required for all interfaces except Get Token).
</ParamField>

<ParamField header="Content-Type" type="string" default="application/json">
  Fixed to `application/json`
</ParamField>

## Path Parameters

<ParamField path="cardholder_no" type="string" required>
  Cardholder order number.
</ParamField>

## Response Parameters

<ResponseField name="code" type="number">
  Response status code. `0` indicates success.
</ResponseField>

<ResponseField name="msg" type="string">
  Response message.
</ResponseField>

<ResponseField name="data" type="object">
  Response data.

  <Expandable title="data">
    <ResponseField name="cardholder_no" type="string">Cardholder order number</ResponseField>
    <ResponseField name="cardholder_unique_no" type="string">Merchant-side unique cardholder number</ResponseField>
    <ResponseField name="email" type="string">Email</ResponseField>
    <ResponseField name="status" type="string">Cardholder status, see \[Appendix - Constants] Cardholder Status</ResponseField>
    <ResponseField name="total_balance" type="string">Total account balance (USD)</ResponseField>
    <ResponseField name="time" type="number">Cardholder creation time (Unix milliseconds)</ResponseField>

    <ResponseField name="card_list" type="object[]">
      Successfully issued card list.

      <Expandable title="card_list">
        <ResponseField name="card_no" type="string">Card order number</ResponseField>
        <ResponseField name="card_last_no" type="string">Last four digits of card number</ResponseField>
        <ResponseField name="card_type" type="string">Card type, see \[Appendix - Constants] Card Types</ResponseField>
        <ResponseField name="time" type="number">Card creation time (Unix milliseconds)</ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="account_list" type="object[]">
      Account list.

      <Expandable title="account_list">
        <ResponseField name="balance" type="string">Currency amount</ResponseField>
        <ResponseField name="usd_balance" type="string">USD amount</ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash Request theme={null}
  curl --request GET \
    --url https://sandbox-openplatform.keysecure.io/open-api/v1/cardholder/U202605220001/info \
    --header 'Content-Type: application/json' \
    --header 'Api-Key: your_api_key' \
    --header 'Timestamp: 1716307200000' \
    --header 'Access-Token: your_access_token'
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
    "code": 0,
    "msg": "Success",
    "data": {
      "cardholder_no": "",
      "cardholder_unique_no": "",
      "email": "",
      "status": "Approved",
      "total_balance": "1000.00",
      "time": 1716307200000,
      "card_list": [{"card_no": "", "card_last_no": "", "card_type": "Virtual", "time": 1716307200000}],
      "account_list": [{"balance": "500.00", "usd_balance": "500.00"}]
    }
  }
  ```
</ResponseExample>