List banking API payments
Read onlyThese 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.
Read only
baas_list_payments
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.
API operation: GET /api/public/v1/transactions/payments — see the operation page
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.
Last verified: 2026-10-07