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

# Retrieve card details

> This endpoint retrieve card details by card id.

### Header

<ParamField header="x-client-id" type="string" required>
  `x-client-id`.
</ParamField>

<ParamField header="x-auth-token" type="string" required>
  Bearer `YOUR_TOKEN_HERE`.
</ParamField>

### Parameters

<ParamField path="card_id" type="string" required>
  Unique Identifier for card.
</ParamField>

### Response

<ResponseField name="code" type="number">
  Indicates whether the call was successful. 200 if successful, 400 if not.
</ResponseField>

<ResponseField name="message" type="string">
  Response Message. "Success" if successful, others not.
</ResponseField>

<ResponseField name="data" type="array">
  <Expandable title="details" defaultOpen>
    <ResponseField name="card_balance" type="string">
      Balance of card.
    </ResponseField>

    <ResponseField name="card_bin" type="string">
      Bin of card.
    </ResponseField>

    <ResponseField name="card_currency" type="string">
      Currency of card.
    </ResponseField>

    <ResponseField name="card_holder_id" type="string">
      The id of the cardholder for the card.
    </ResponseField>

    <ResponseField name="card_name" type="string">
      A name for the card.
    </ResponseField>

    <ResponseField name="card_number" type="number">
      Card number.
    </ResponseField>

    <ResponseField name="card_scheme" type="number">
      Card scheme.
    </ResponseField>

    <ResponseField name="card_status" type="string">
      Current card status.<br />
      One of `PENDING`, `ACTIVE`, `INACTIVE`, `BLOCKED`, `LOST`, `STOLEN`, `CLOSED`, `FAILED`
    </ResponseField>

    <ResponseField name="card_type" type="string">
      Card type.
    </ResponseField>

    <ResponseField name="create_time" type="string">
      Card create time.
    </ResponseField>

    <ResponseField name="form_factor" type="string">
      Form of the card.
    </ResponseField>

    <ResponseField name="update_time" type="string">
      Card update time.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL Example Request theme={null}
  curl 'https://api.sandbox.uqpay.org/api/v1/cards/d3827a04-837b-41d5-8fad-8bdfa232bbb3' \
  -H 'x-auth-token: Bearer 0e043e2ec6898b3220a0921466d7c203' \
  -H 'x-client-id: Up1HIsjiETPXLy7gON9PMG'
  ```
</RequestExample>

<ResponseExample>
  ```json Response theme={null}
  {
      "code": 200,
      "message": "Success",
      "data": {
          "card_balance": "10",
          "card_bin": "491724",
          "card_currency": "USD",
          "card_holder_id": "65dd6638-5c23-4d9c-9672-1e7fd0fb0c14",
          "card_name": "testf's card",
          "card_number": "9333019900054650",
          "card_scheme": "VISA",
          "card_status": "ACTIVE",
          "card_type": "PREPAID",
          "create_time": "2023-10-12T11:52:33+08:00",
          "form_factor": "VIRTUAL",
          "update_time": "2023-10-12T17:04:15+08:00"
      }
  }
  ```
</ResponseExample>