get https://api.cardda.com/v1/banking/bank_transactions
Returns a paginated list of bank transactions for authorized accounts. This endpoint provides comprehensive filtering, sorting, and pagination capabilities to help you query transaction history effectively.
Key Features
- Pagination: Control result size with
_start
and_end
parameters (default: 25 items) - Sorting: Sort by any field in ascending or descending order
- Filtering: Apply complex filters on multiple fields including amounts, dates, and statuses
- Relationships: Automatically includes related entities (recipients, senders, payables, errors)
Authorization
- Regular users can only view transactions from accounts they have access to through a bank key.
Response Structure
The response includes the transaction details along with nested relationships:
- recipient: Full recipient information including bank details
- sender: Bank account information of the sender
- bank_errors: Any errors encountered during processing
- payables: Related invoices (if Pay product is activated)
- payroll: Associated payroll information (if applicable)
Common Use Cases
- Get recent transactions: Use default pagination without filters
- Find high-value transactions: Filter by amount range
- Check transaction status: Filter by specific status values
- Audit trail: Sort by
created_at
orupdated_at
with date filters - Reconciliation: Filter by
external_id
or date ranges