# List Card Balances & Transactions

## Get Card Balances

Retrieve the balances for all customer-associated cards. This endpoint provides detailed balance information for each card related to the customer, ensuring a full overview of available and spent credit limits.

* **HTTP Method:** GET
* **Endpoint:** `/api/v1/customer/cards/balances`

**Request Parameters**

* **PageSize** (optional, default = 10): Number of records to be returned
* **PageNumber** (Optional, default = 1): Index of page to be returned
* **CustomersID** (Optional): Filter to return cards belonging to a specific CustomersID

**Header Parameter**

* otp: **required**

#### **Response**

**Example Response (Status Code**: 200 OK)

```json
{
  "id": 0,
  "details": [
    {
      "id": 0,
      "customersReference": "string",
      "cardHolderName": "string",
      "cardLast4": "string",
      "customersID": "string",
      "currency": "string",
      "totalBalance": 0,
      "availableBalance": 0,
      "pendingBalance": 0,
      "status": "string"
    }
  ],
  "pageSize": 0,
  "pageNumber": 0,
  "numberOfPages": 0,
  "status": "string",
  "errors": [
    {
      "fieldName": "string",
      "messageCode": "string"
    }
  ]
}
```

**Notes**

* The balances returned are up-to-date at the time of request and may vary based on pending transactions.

***

## Get Transactions

Retrieves a list of card transactions, with the ability to filter by `CardsId` and include a date range.

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

**Request Query Parameters**:

* `CardsId`: Use this parameter to filter transactions by the specific Card ID.
* `fromDate` (ISO 8601 UTC date, Optional): The start date for transaction filtering.
* `toDate` (ISO 8601 UTC date, Optional): The end date for transaction filtering.
* `PageNumber`: Indicate the page number to retrieve; defaults to 1 if not specified.
* `PageSize`: Define the number of transactions per page; defaults to 10 if not specified.

**Example Response (Status Code**: 200 OK)

```json
{
  "id": 0,
  "details": [
    {
      "id": 0,
      "cardsId": 0,
      "amount": 0,
      "currency": "string",
      "description": "string",
      "dateTime": "2025-12-05T18:30:19.218Z",
      "bPending": true,
      "refundTransactionsID": "string"
    }
  ],
  "pageSize": 0,
  "pageNumber": 0,
  "numberOfPages": 0,
  "status": "string",
  "errors": [
    {
      "fieldName": "string",
      "messageCode": "string"
    }
  ]
}
```

**Note**

* The transactions returned are reflective of all activity within the specified time frame and account for all completed, pending, and approved transactions.


---

# 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/list-card-balances-and-transactions.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.