# Get Card Details

**Method:** `POST`

**Path:** `/api/pay/v1/getCardDetails`

**Category:** Card Payments

**Authentication:** Required

## Description

Use this API to get the card details.


## Request Body

Content-Type: `application/json`

- `amount` (`string`) — Transaction amount in smallest currency unit.
- `card_details` (`CardDetailLookupItem[]`) **required** — An array that contains the card details.
  - `payment_identifier` (`string`) **required** — Card Number. - Minimum length: 12 characters. - Maximum length: 19 characters. - Supported characters: 0-9 
  - `payment_reference_type` (`CARD | ALT_TOKEN_TXN | NETWORK_TOKEN_TXN | ISSUER_TOKEN_TXN`) **required** — Type of payment method you want to use to accept a payment.


### Example Request

```json
{
  "amount": "100",
  "card_details": [
    {
      "payment_identifier": "4012001037141112",
      "payment_reference_type": "CARD"
    }
  ]
}
```

## Responses

- `200` — Card details retrieved successfully.
- `400` — 
- `422` — Unprocessable entity — invalid card number format.
- `500` — 
- `503` — Service temporarily unavailable.

### Response Schema

- `card_payment_details` (`CardPaymentDetailItem[]`) — Array of card payment details matching the lookup.
  - `card_network` (`string`) — Card network provider.
  - `card_issuer` (`string`) — Card issuing bank or institution.
  - `card_type` (`string`) — Type of card.
  - `card_category` (`string`) — Card category.
  - `is_international_card` (`boolean`) — Whether the card is an international card.
  - `is_native_otp_supported` (`boolean`) — Whether the card supports native OTP flow.
  - `country_code` (`string`) — Country code of the card issuer.
  - `currency` (`string`) — Currency associated with the card.
  - `is_currency_supported` (`boolean`) — Whether the card's currency is supported for transactions.


### Example Response

```json
{
  "card_payment_details": [
    {
      "card_network": "VISA",
      "card_issuer": "INTL HDQTRS-CENTER OWNED",
      "card_type": "CREDIT",
      "card_category": "NONE",
      "is_international_card": false,
      "is_native_otp_supported": true,
      "country_code": "IND",
      "currency": "INR",
      "is_currency_supported": true
    }
  ]
}
```

---

Reference: https://localhost:3000/api/card-payments/get-card-details