# Card List

It is used to list the stored cards of the relevant user.

{% hint style="success" %}
<https://api.paynet.com.tr/v1/card/list>
{% endhint %}

{% tabs %}
{% tab title="Request Parameters" %}

| Parameter Name      | Type   | Required | Description                                                                                                                                                       |
| ------------------- | ------ | -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **card\_owner\_id** | string | Yes      | Unique card holder information that has been generated by Paynet.                                                                                                 |
| **limit**           | int    | No       | The number of data to return. Default 10 records return.                                                                                                          |
| **ending\_before**  | int    | No       | It returns the number of records before the specified index. Example, If ending before is 90 and Limit is 15 it returns records of between 75th and 90th records. |
| **starting\_after** | int    | No       | It returns the number of records after the specified index. Example, If Starting after is 15 and Limit is 15 it returns records of between 15th and 30th records. |
| {% endtab %}        |        |          |                                                                                                                                                                   |

{% tab title="Response Parameters" %}

| Parameter Name        | Type   | Description                                                                                            |
| --------------------- | ------ | ------------------------------------------------------------------------------------------------------ |
| **card\_desc**        | string | The name given to stored card.                                                                         |
| **card\_hash**        | string | Hash value of card number.                                                                             |
| **card\_no**          | string | Tokenized version of the first 6 and last 4 numbers of the card number.                                |
| **card\_bin**         | string | First 6 digits of card number.                                                                         |
| **card\_type**        | string | Card type. [Expr](https://doc.paynet.com.tr/genel-bilgiler/veri-tipleri/kart-tipi)                     |
| **card\_bank\_name**  | string | The bank name of the card. (Bonus,Axess etc.)                                                          |
| **card\_logo\_url**   | string | Logo image of the card.                                                                                |
| **card\_brand\_name** | string | VISA, MASTERCARD,AMEX                                                                                  |
| **card\_owner\_id**   | string | Unique card holder information that has been generated by Paynet.                                      |
| **user\_unique\_id**  | string | The Unique value which is generated by member workplace. Value that sent in the first save process.    |
| **object\_name**      | string | Object name of the response API.                                                                       |
| **code**              | string | Code of response result. [Expr](https://doc.paynet.com.tr/genel-bilgiler/hata-kodlari/doenues-kodlari) |
| **message**           | string | Response result message.                                                                               |
| {% endtab %}          |        |                                                                                                        |

{% tab title="Request" %}

```
{
     “card_owner_id”:”1d16eaa18-f00d-492d-868a-856412b7577d1”
 }
```

{% endtab %}

{% tab title="Response" %}

```
{
    "total": 1,
    "total_count": 2,
    "limit": 10,
    "ending_before": 0,
    "starting_after": 0,
    "has_more": false,
    "Data": [
        {
            "company_code": "10031",
            "agent_id": "10031",
            "user_unique_id": "DCFC03FA-F053-41BD-9DCA-E3178C84FB22",
            "card_owner_id": "f4dabd79-5b7e-40bd-84d5-54058242dfa0",
            "card_hash": "d9124b54-162a-45c3-b09a-0388af1c891e",
            "card_desc": "Paynet Ödeme Hizm.",
            "card_holder": "RQ*****QR",
            "card_no": "434678********0002",
            "card_bin": "434678",
            "card_type": "cc",
            "card_bank_id": "AXSS",
            "card_bank_name": "Axess",
            "card_logo_url": "http://localhost:64102/img/banklogo/small/AXSS.png",
            "card_brand_name": "VISA",
            "expire_month": 0,
            "expire_year": 0
        }
    ],
    "object_name": "card_list",
    "code": 0,
    "message": null
}
```

{% endtab %}

{% tab title="Service URL" %}

| System          | URL                                                                                                                                                                                 |
| --------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Live System** | [https://api.paynet.com.tr\[/v1/card/list](https://doc.paynet.com.tr/english/card-save/https:/api.paynet.com.tr\[/v1/card/list)]\(<https://api.paynet.com.tr/v1/card/list>)         |
| **Test System** | [https://pts-api.paynet.com.tr\[/v1/card/list](https://doc.paynet.com.tr/english/card-save/https:/pts-api.paynet.com.tr\[/v1/card/list)]\(<https://api.paynet.com.tr/v1/card/list>) |
| {% endtab %}    |                                                                                                                                                                                     |
| {% endtabs %}   |                                                                                                                                                                                     |