# Get Customer Cards

## Get Customer Cards

List cards for all managed customers

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

{% openapi src="<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>" 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="<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>" 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": []
}
```