Search bank transactions
POST/v1/bank-transactions/search-query
Returns a paginated list of bank transactions for a specific 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 three filters: bankAccountId, bookingDateFrom, and bookingDateTo. Pagination and sorting are optional; results are sorted by bookingDate descending by default.
Request
Responses
- 200
- 400
- 401
- 403
- 429
- 500
- 502
- 503
- 504
Bank transactions data
Response Headers
Maximum number of requests allowed in the current rate limit window for the used scope.
Number of requests remaining in the current rate limit window.
Unix timestamp (seconds since epoch, UTC) when the rate limit window resets.
The OAuth scope bucket to which this rate limit applies: read or write.
Bad request (e.g., invalid filter parameters)
Unauthorized
Forbidden (e.g., user has no organizations, insufficient scope privileges)
Rate limit exceeded. Reduce request frequency and retry after the indicated number of seconds.
Response Headers
Maximum number of requests allowed in the current rate limit window for the used scope.
Number of requests remaining in the current rate limit window.
Unix timestamp (seconds since epoch, UTC) when the rate limit window resets.
The OAuth scope bucket to which this rate limit applies: read or write.
Number of seconds to wait before retrying. Only present on 429 Too Many Requests responses.
Internal server error
Bad gateway. An upstream service could not be reached.
Service temporarily unavailable. An upstream service returned a 503 error.
Gateway timeout. An upstream service did not respond in time.