# List banking API payments

> Reads your account's payments: valid accountValue → currency → accountIndex (1-based) → sole account. Date, status, currency, method and direction filters; cursor pagination.

- kind: mcp-tool
- status: stable
- access: read
- last_verified: 2026-10-07
- url: https://tilopay.com/en/developers/agentes/mcp/api-bancario/list-payments

> These tools are enabled on request and only work for users with Tilopay banking API credentials. They are not part of the default MCP access: Tilopay enables the group case by case. Requires: Tilopay banking API credentials registered by Tilopay for that user.

- `baas_list_payments`
- Access: Read only
- API operation: `GET /api/public/v1/transactions/payments` — https://tilopay.com/en/developers/api-bancario/pagos

Queries (read-only) the movements/payments of one of the merchant's own bank accounts. Indicate the currency (CRC/USD) or the account number from the list: do not write the IBAN. Filters by date, status, currency, method and direction, with cursor pagination.

**Parameters**

| Parameter | Type | Required | Description |
| --- | --- | --- | --- |
| `currency` | string | — | ISO 4217 currency (CRC, USD) |
| `accountIndex` | integer | — | Account number in the list shown by baas_list_accounts (base 1). Precedence for choosing the own account: accountValue (only if it matches one of the user's accounts) → currency (first account in that currency) → accountIndex (base 1: the number baas_list_accounts shows) → if there is a single account, that one. |
| `accountValue` | string | — | Only if already returned by a tool and matching one of your accounts. Account precedence: accountValue → currency (first matching account) → accountIndex (1-based) → sole account. |
| `assignmentId` | string | — | Banking API context (assignment); only needed when there are several |
| `dateFrom` | string | — | From, RFC 3339 (2026-01-01T00:00:00Z) |
| `dateTo` | string | — | To, RFC 3339 |
| `status` | string (pending | processing | confirmed | posted | failed) | — | Public payment status |
| `paymentMethodCode` | string (PIN | SINPE_MOVIL) | — | Payment method |
| `direction` | string (OUT | IN) | — | OUT = sent, IN = received |
| `clientReference` | string | — | Merchant reference |
| `limit` | integer | — | Page size, 100 maximum (20 by default) |
| `cursor` | string | — | Cursor from the previous page |

**Returns**

`{ result }`

result = the banking API response as returned, with its pagination cursor.