Overview
This node integrates with the Splitwise API to manage groups and expenses. Specifically, for the Group - Get Many operation, it retrieves a list of all groups associated with the authenticated user. This is useful for scenarios where you want to display or process multiple groups at once, such as generating reports, syncing group data with other systems, or managing group memberships in bulk.
Practical examples:
- Fetching all groups to show in a dashboard.
- Synchronizing group information with an external database.
- Automating notifications or reminders based on group activity.
Properties
| Name | Meaning |
|---|---|
| Authentication | Method used to authenticate API requests. Options: "API Key" or "OAuth2". |
| Note: Expenses that are not associated with a group are listed in a group with ID 0. | Informational notice explaining how ungrouped expenses are handled by the API. |
Output
The output JSON contains an array of group objects under the json field. Each group object includes details about a Splitwise group, such as its ID, name, members, and other metadata as returned by the Splitwise API's /get_groups endpoint.
No binary data is output by this operation.
Example structure (simplified):
[
{
"id": 12345,
"name": "Trip to Spain",
"members": [...],
"created_at": "...",
"updated_at": "..."
},
{
"id": 67890,
"name": "Roommates",
"members": [...],
"created_at": "...",
"updated_at": "..."
}
]
Dependencies
- Requires valid authentication credentials for the Splitwise API, either via an API key or OAuth2 token.
- The node uses the base URL
https://secure.splitwise.com/api/v3.0. - No additional environment variables or external services beyond Splitwise API access are required.
Troubleshooting
Common issues:
- Invalid or expired authentication credentials will cause API request failures.
- Network connectivity problems can prevent successful API calls.
- Rate limiting by Splitwise API may result in errors if too many requests are made in a short time.
Error messages:
- Errors from the API are thrown as node operation errors with descriptive messages.
- If the API returns an error array, the messages are concatenated and presented.
- To resolve errors, verify authentication credentials, check network status, and ensure API usage complies with Splitwise limits.