post https://secure.mintpayments.com/mpay/v5/open-banking/transactions/search
Search bank account transactions using complex criteria in request body.
About Open Banking Transactions
Open Banking transactions represent all transaction activity pulled directly from customers' bank accounts through secure banking APIs (such as AISP - Account Information Service Provider in the UK). This includes:
- All transactions on the bank account, not just Mint-related activity
- Purchases, refunds, transfers, direct debits, standing orders, etc.
- Transactions from all merchants and service providers
- Both incoming and outgoing transactions
- Raw bank statement data with original descriptions and amounts
This data provides a complete view of the customer's bank account activity and is used for:
- Account reconciliation and matching
- Financial analysis and insights
- Transaction categorization and reporting
- Identifying Mint-related transactions within the broader account activity
Note: This is different from funds transfers, which are specifically debits or credits initiated by Mint to merchants.
Bank Account Filtering
The search supports multiple bank account identifier parameters (iban, routing_account_number, bank_account_id) that are applied exclusively:
- All provided bank account identifiers must match the same bank account
- If multiple identifiers are provided but don't all correspond to the same account, no records will be returned
- This ensures data consistency and prevents accidental cross-account queries
Examples:
- ✅
bank_account: "BA.123"+iban: "GB82WEST12345698765432"(if they match the same account) - ❌
bank_account: "BA.123"+iban: "GB82WEST99999999999999"(if they match different accounts) - ✅
iban: "GB82WEST12345698765432"only - ✅
routing_account_number: {...}+bank_account: "BA.123"(if they match the same account)