Entity → Get Many
AI-generatedOverview
This node interacts with the GPortal Entity API to retrieve multiple entities based on specified search parameters. It is useful for scenarios where you need to fetch a list of entities filtered by certain criteria, such as status or category, with control over the number of results and versioning. For example, you can use it to get all active entities of a specific category or to retrieve entities matching custom search fields.
Use Case Examples
- Retrieve up to 50 active entities of category 'A' with version '0'.
- Fetch entities by specifying custom search parameters in JSON format.
Properties
| Name | Meaning |
|---|---|
| Entity Name or ID | Specifies the entity name or ID to search for entities. |
| Search Parameters | JSON formatted search parameters to filter the entities, e.g., { "status": "active", "category": "A" }. |
| Limit | Maximum number of entities to return. |
| Version | Version to include in the search fields. |
| Additional Fields | Additional query parameters to include in the request. |
Output
JSON
json- The JSON response containing the list of entities matching the search criteria.
Dependencies
- Requires an API key credential for GPortal API authentication, including the domain URL.
Troubleshooting
- Ensure the 'Entity Name or ID' is provided and valid; missing or invalid values will cause errors.
- Search Parameters must be valid JSON; parsing errors will throw exceptions.
- Check API credentials and domain URL configuration if requests fail.
- If the node throws errors related to unsupported operations or resources, verify the selected operation and resource are correct.
Links
- n8n Expressions Documentation - Reference for using expressions to specify dynamic values in node parameters.