# Receiving a list of cards

## Request for a list of saved cards 

<mark style="color:blue;">`GET`</mark> `https://prapi.tarlanpayments.kz/transaction/api/v1/system/client/cards`

#### Query Parameters

| Name                                                  | Type    | Description                                |
| ----------------------------------------------------- | ------- | ------------------------------------------ |
| merchant\_id<mark style="color:red;">\*</mark>        | Integer | Merchant ID assigned by the payment system |
| project\_client\_id<mark style="color:red;">\*</mark> | String  | Client ID on the project side              |
| project\_id<mark style="color:red;">\*</mark>         | Integer | Project ID assigned by the payment system  |

#### Headers

| Name          | Type   | Description                                        |
| ------------- | ------ | -------------------------------------------------- |
| Authorization | String | Bearer Auto-rotation hash (see Signature Creating) |

{% tabs %}
{% tab title="200: OK Example of a successful response" %}

```json
{
    "status": true,
    "message": "Success",
    "result": [
        {
            "card_token": "",
            "masked_pan": "0000-00XXXXXX-0000"
        },
        {
            "card_token": "",
            "masked_pan": "0000-00XXXXXX-0000"
        },
        {
            "card_token": "",
            "masked_pan": "0000-00XXXXXX-0000"
        }
    ]
}
```

{% endtab %}

{% tab title="500: Internal Server Error Example of an error response" %}

```json
{
    "status": false,
    "status_code": 1021,
    "message": "request validation error",
    "result": {}
}
```

{% endtab %}
{% endtabs %}

{% code overflow="wrap" lineNumbers="true" fullWidth="true" %}

```bash
curl --location 'https://prapi.tarlanpayments.kz/transaction/api/v1/system/client/cards?merchant_id=999&project_id=999&project_client_id=999' \
--header 'Authorization: Bearer sign' \
--data ''
```

{% endcode %}