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


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://doc.paynet.com.tr/english/card-save/card-list.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.