AvantGuard - DNSFilter icon

AvantGuard - DNSFilter

AvantGuard - DNSFilter

Actions277

Overview

This node operation retrieves a list of organizations from an external service. It allows users to fetch all organizations with optional filtering and pagination parameters. This is useful in scenarios where you need to manage or analyze organizational data, such as listing all client companies, MSPs (Managed Service Providers), or sub-organizations within a system.

Practical examples include:

  • Fetching all organizations to display in a dashboard.
  • Filtering organizations by type or name for reporting.
  • Paginating through large sets of organizations to process them in batches.

Properties

Name Meaning
Additional Query Parameters Optional filters and pagination options:
- Basic Info Boolean flag to return only basic info about organizations (true/false, default true).
- Managed By Msp Id Number filter to get MSP sub-organizations matching this MSP ID.
- Name String filter to search organizations by their name.
- Owned Msp Id Number filter to get parent organizations matching this MSP ID.
- Page JSON object specifying page number and size for pagination.
- Type Filter by organization type; options are Normal, Msp, or Sub Organization (default: Normal).

Output

The node outputs JSON data containing the list of organizations retrieved based on the query parameters. Each item in the output typically represents an organization object with its details as returned by the API.

If binary data were supported, it would be summarized here, but this node focuses on JSON responses representing organizational data.

Dependencies

  • Requires an API key credential for authenticating requests to the external service.
  • The base URL for API requests is https://api.dnsfilter.com.
  • The node uses standard HTTP headers for JSON content negotiation.

Troubleshooting

  • Common issues:

    • Invalid or missing API credentials will cause authentication errors.
    • Incorrectly formatted query parameters (e.g., invalid JSON in the "Page" property) may result in request failures.
    • Filtering by non-existent MSP IDs or organization names may return empty results.
  • Error messages:

    • Authentication errors usually indicate problems with the provided API key; verify and update credentials.
    • Validation errors on query parameters suggest checking the format and allowed values.
    • Network or timeout errors require checking connectivity and API availability.

Links and References

Discussion