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 detailed information about a specific representative by their unique identifier. It is useful in scenarios where you need to fetch and process compliance, contact, or status details of representatives associated with an account or business entity.
Practical examples include:
- Fetching representative data for verification or auditing purposes.
- Integrating representative details into CRM or compliance workflows.
- Automating updates or notifications based on representative status changes.
Properties
| Name | Meaning |
|---|---|
| Representative Id | The unique identifier of the representative whose details are to be retrieved (required). |
| Request Id | Optional client-generated identifier to trace and debug a single request (sent as header). |
| Correlation Id | Optional client-generated identifier to trace and debug a series of related requests (header). |
Output
The node outputs JSON data representing the full details of the requested representative. The structure includes:
- address: Object containing address lines, city, state, postal code, and country code.
- compliance_profile: Compliance-related info such as date of birth, last 4 digits of SSN, and ID document details.
- capabilities: Supported payment types and customer types.
- settings: Charge and payout settings including enabled flags and limits.
- industry: Business industry classification details.
- support_channels: Contact information like email, phone, and website URL.
- bank_details: Bank account information linked to the representative.
- status_details: Status messages, reasons, sources, and timestamps related to the representative's current state.
- verification: Verification status, method, attempts, and completion time.
- bank_data: Additional bank account data fields.
No binary data output is indicated.
Dependencies
- Requires an API key credential for authenticating with the Straddle API.
- The base URL for API requests depends on the configured environment (e.g., production or sandbox).
- Proper network access to the Straddle API endpoint is necessary.
Troubleshooting
- Missing or invalid Representative Id: Ensure the Representative Id property is provided and correctly formatted.
- Authentication errors: Verify that the API key credential is valid and has sufficient permissions.
- Network issues: Check connectivity to the Straddle API endpoint and firewall settings.
- Rate limiting or quota exceeded: If the API returns rate limit errors, consider implementing retries or reducing request frequency.
- Unexpected response structure: Confirm that the API version matches the node’s expectations; schema changes may cause parsing issues.
Links and References
- Straddle API Documentation (general reference for API endpoints and data models)
- n8n documentation on creating custom nodes