Skip to main content
Version: 1.39.2

Search bank transactions

POST 
/v1/bank-transactions/search-query

Returns a paginated list of bank transactions, optionally filtered by bank account, within a date range.

Bank transactions represent money movements in Moss wallets, including card purchases, payouts to external bank accounts, top-ups, ATM withdrawals, and repayments. Each transaction includes the total amount (inclusive of any fees), booking and value dates, and an array of associated fees broken down by type (e.g., FX fee, payment fee).

The request body requires bookingDateFrom and bookingDateTo. Use optional accountIds to filter one or more bank accounts. The deprecated optional bankAccountId filter is still accepted for backwards compatibility. Provide either accountIds or bankAccountId, not both. Pagination and sorting are optional; results are sorted by bookingDate descending by default.

Request​

Responses​

Bank transactions data

Response Headers
    X-RateLimit-Limit

    Maximum number of requests allowed in the current rate limit window for the used scope.

    X-RateLimit-Remaining

    Number of requests remaining in the current rate limit window.

    X-RateLimit-Reset

    Unix timestamp (seconds since epoch, UTC) when the rate limit window resets.

    X-RateLimit-Scope

    The OAuth scope bucket to which this rate limit applies: read or write.