# Получение списка карт

## Запрос на получения списка сохраненных карт

<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 | Идентификатор мерчанта присваиваемый платежной системой |
| project\_client\_id<mark style="color:red;">\*</mark> | String  | Идентификатор клиента на стороне проекта                |
| project\_id<mark style="color:red;">\*</mark>         | Integer | Идентификатор проекта присваиваемый платежной системой  |

#### Headers

| Name          | Type   | Description                                                                                                                    |
| ------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------ |
| Authorization | String | Bearer  Авторотационный хэш (см [Формирование подписи](https://docs.tarlanpayments.kz/platezhnyi-shlyuz/formirovanie-podpisi)) |

{% tabs %}
{% tab title="200: OK Пример успешного ответа" %}

```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 Пример ответа с ошибкой" %}

```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 %}