---
title: "insight_findObjects"
canonical: "https://support.appfire.com/space/PSJ/15487766/insight_findObjects"
format: markdown
---
> Macro (aura-html)


|  |  |  |  |
| --- | --- | --- | --- |
| **Syntax** | insight_findObjects(iql) | **Package** | insight |
| **Alias** |  | **Pkg Usage** | findObjects(iql) |

## Description

> Macro (excerpt)
> 
> Runs a IQL over insight and returns all objects found.

Runs a IQL over insight and returns all objects found.

## Parameters

| Parameter name | Type | Required | Description |
| --- | --- | --- | --- |
| iql | String | Yes | The IQL to be used in the search for objects. |

## Return Type

**[IObjectType []](https://appfire.atlassian.net/wiki/spaces/PSJ/pages/15488625)**

> ⚠️ For more information about IQL searches [click here.](https://support.atlassian.com/jira-service-management-cloud/docs/use-insight-query-language-iql)

## See also

> Macro (contentbylabel)