# Get Customer Cards

## Get Customer Cards

List cards for all managed customers

* **Endpoint:** `/api/v1/customer/cards/byuser/list`
* **Method:** GET

{% openapi src="/files/jy1U2qiRUqspQuQBhZGz" path="/api/v1/customer/cards/byuser/list" method="get" %}
[public-api-customer-role (4).json](https://1042261367-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxYGT6bxbvntyOdsHjmeN%2Fuploads%2Fgit-blob-1d89ce851f17d792a1fd40d557b07a1ec5acd080%2Fpublic-api-customer-role%20\(4\).json?alt=media)
{% endopenapi %}

**Query Parameters:**

* `pageNumber` (Integer, Optional): The page of results to return.
* `pageSize` (Integer, Optional): The maximum number of results to return per page.

***

## Get Cards By Customer

The "Get Customer Cards" feature is a way for users to view all the cards and card details associated with their customers. This list provides essential information such as the card's balance, pending transactions, and whether the card is currently active or disabled. This is particularly helpful for keeping an overview of all customer activity and ensuring that their cards are properly managed.

* **Endpoint:** `/api/v1/customer/cards/byuser`
* **Method:** `GET`

{% openapi src="/files/v26YtDRIkV6wiBPah7nY" path="/api/v1/customer/cards/byuser" method="get" %}
[PublicAPI-April16.json](https://1042261367-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FxYGT6bxbvntyOdsHjmeN%2Fuploads%2Fgit-blob-c8d5f9dcad96517eae48c21ca883167a3d1730b6%2FPublicAPI-April16.json?alt=media)
{% endopenapi %}

**Query Parameters:**

* `customersId`(Integer, Optional): The customer's ID for which the card details will be retrieved.

**Request Example:**

To request the list of managed cards using pagination:

```json
GET /api/v1/customer/cards/byuser?customersId=11057
```

**Response Body Parameters:**

* `id` (Integer): Not used.
* `details` (Array of Objects):
  * `customersId` (Integer): ID of the customer.
  * `customersReference` (String): The customer reference used when creating the customer.
  * `cards` (Array of Objects):
    * `id` (Integer): ID of the customer's card.
    * `currency` (String): Currency of the card.
    * `totalBalance` (Decimal): Total balance on the card.
    * `availableBalance` (Decimal): The available balance on the card.
    * `pendingBalance` (Decimal): Sum of all pending transaction amounts.
    * `bSuppressed` (Boolean): True if use of this card is disabled.

**Success Response Example:**

```json
{
  "id": 0,
  "details": [
    {
      "customersId": 0,
      "customersReference": "string",
      "cards": [
        {
          "id": 0,
          "currency": "usd",
          "totalBalance": 0,
          "availableBalance": 0,
          "pendingBalance": 0,
          "bSuppressed": true
        }
      ]
    }
  ],
  "pageSize": 10,
  "pageNumber": 1,
  "status": "1",
  "errors": []
}
```


---

# 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://customer-api-docs.ibanera.com/api-endpoints/cards/get-customer-cards.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.