Actions81
- Users Actions
- Organizations Actions
- Representatives Actions
- Bridge Actions
- Platforms Actions
- Tools Actions
- User Invites Actions
- Customers Actions
- Paykeys Actions
- Reports Actions
- Charge Actions
- Funding Events Actions
- Payments Actions
- Payout Actions
- Accounts Actions
- Get Account By Id
- put__v1_accounts_account_id
- Create Account
- get__v1_accounts
- post__v1_accounts_account_id_onboard
- post__v1_accounts_account_id_simulate
- patch__v1_internal_accounts_account_id
- get__v1_internal_accounts_account_id
- patch__v1_internal_accounts_account_id_status
- get__v1_internal_accounts_account_id_settings
- Capability Requests Actions
- Linked Bank Accounts Actions
Overview
This node interacts with the Straddle API to retrieve information about linked bank accounts. Specifically, the get__v1_linked_bank_accounts operation fetches a paginated list of linked bank accounts associated with an account or all linked accounts if no specific account ID is provided.
Common scenarios where this node is useful include:
- Retrieving a list of bank accounts linked to a user or business for reconciliation or reporting.
- Fetching bank account details to verify linkage status or verification state.
- Integrating with financial workflows that require up-to-date bank account information from Straddle.
Practical example:
- A finance team wants to automate monthly reports on all linked bank accounts and their verification statuses. This node can be used to paginate through all linked accounts, sorted by ID, and extract relevant details for further processing.
Properties
| Name | Meaning |
|---|---|
| Account Id | The unique identifier of the related account. If provided, limits results to this account. |
| Page Number | Results page number to retrieve. Starts at 1. Default is 1. |
| Page Size | Number of results per page. Default is 100, maximum allowed is 1000. |
| Sort By | Field to sort results by. Default is "id". |
| Sort Order | Sort direction: Asc (ascending) or Desc (descending). Default is Asc. |
| Request Id | Optional client-generated identifier to trace and debug a request. |
| Correlation Id | Optional client-generated identifier to trace and debug a series of requests. |
Output
The node outputs JSON data representing the linked bank accounts retrieved from the API. Each linked bank account object includes detailed properties such as:
- bank_details: Information about the bank account including routing number, masked account number, account type (checking/savings), and bank name.
- status_details: Status message, reason, source, and timestamp of last status change.
- verification: Verification status, method used, number of attempts, and completion timestamp.
- Additional metadata fields describing the linked bank account's compliance, capabilities, settings, industry, support channels, and more.
No binary data output is indicated for this operation.
Dependencies
- Requires an API key credential for authenticating with the Straddle API.
- The base URL for API requests is dynamically set based on the environment configured in credentials.
- Proper network access to the Straddle API endpoint is necessary.
Troubleshooting
- Empty or missing results: Ensure the correct
Account Idis provided if filtering by account. Otherwise, check pagination parameters. - Invalid authentication errors: Verify that the API key credential is correctly configured and has appropriate permissions.
- Rate limiting or throttling: If many pages are requested rapidly, the API may throttle requests. Implement retry logic or respect rate limits.
- Incorrect sorting or unexpected order: Confirm that
Sort ByandSort Ordervalues are valid and supported by the API. - Debugging issues: Use the optional
Request IdandCorrelation Idheaders to trace requests in logs or support tickets.
Links and References
- Straddle API Documentation (general reference for API endpoints and data models)
- Pagination and sorting concepts in REST APIs (for understanding page_number, page_size, sort_by, sort_order usage)