Actions37
- Authentication Actions
- Contacts Actions
- Book Entries Actions
- Invoices Actions
- Tickets Actions
- Paysheets Actions
- Numbering Series Actions
- Accounting Categories Actions
- Accounting Subcategories Actions
- Attachments Actions
Contacts → Get Contacts
AI-generatedOverview
This node interacts with the Quipu API to retrieve a list of contacts based on various filter criteria. It is useful for scenarios where you need to search, filter, and paginate through contacts such as clients, suppliers, employees, or other categories within an invoicing or accounting system. For example, you can fetch all client contacts from a specific country or filter contacts by tax ID or email.
Use Case Examples
- Retrieve all client contacts from Spain.
- Search contacts by a specific tax ID.
- Get contacts filtered by kind (e.g., income or expenses) and sorted by issue date.
Properties
| Name | Meaning |
|---|---|
| Filter Q | Search query to filter contacts by a general search term. |
| Filter Kind | Filter contacts by their kind/category such as income, expenses, employee, supplier, client, or assets. |
| Filter Tax Id | Filter contacts by their tax identification number. |
| Filter Country | Filter contacts by one or more countries, specified as a comma-separated string. |
| Filter Email | Filter contacts by their email address. |
| Sort | Sort criteria for the contacts list, e.g., by issue date or total amount. |
| Page Number | Page number for paginated results to navigate through multiple pages of contacts. |
Output
JSON
contacts- Array of contact objects returned by the API, each representing a contact with its details.
Dependencies
- Quipu API authentication credential required to access the Quipu invoicing and accounting API.
Troubleshooting
- Ensure the API credentials are correctly configured and valid to avoid authentication errors.
- Check that the filter parameters are correctly formatted, especially for comma-separated values like countries.
- If pagination is used, verify that the page number is within the valid range to avoid empty results.
- Timeout or network errors may occur if the server is unreachable or slow; adjust the timeout setting if necessary.
Links
- Quipu API Documentation - Official API documentation for Quipu, detailing endpoints, parameters, and usage.