---
title: "How to use Asset Query Language syntax?"
canonical: "https://support.appfire.com/space/ATCFJ/1076823082/How%20to%20use%20Asset%20Query%20Language%20syntax%3F"
format: markdown
---
> Macro (aura-html)

Assets Query Language (AQL) is a language format used in Assets in Jira Service Management to create search queries for one or more objects.

### Basic syntax

The basic syntax of an AQL query is **<attribute> <operator> <value/function>**. The query returns one or more objects when the attributes of these objects match the operator and value specified. 

> ℹ️ To know more about Assets Query Language, refer to
> ℹ️ 
> ℹ️ - [Using Assets Query Language syntax](https://support.atlassian.com/jira-service-management-cloud/docs/use-assets-query-language-aql/) (Cloud)
> ℹ️ - [Advanced searching: AQL - Assets Query Language](https://confluence.atlassian.com/servicemanagementserver/advanced-searching-aql-assets-query-language-1044784588.html) (Data Center and Server)

| **Example** | **Query** |
| --- | --- |
| Limit the search result to a specific object schema name. | ```
objectSchema = "ITSM Schema"
``` |
| Limit the search result on object schema ids. | ```
objectSchemaId in (1, 2)
``` |
| Limit the search result to a specific object type. | ```
objectType = "Employment Start Date"
``` |
| Limit the search result on object type ids. | ```
objectTypeId in (1, 2)
``` |
| Search all attributes on all objects for a relevant match. | ```
"anyAttribute = 123.123.123.123"
``` |
| Limit the search to the object having any inbound references to it. | ```
"object having inboundReferences()"
``` |
| Find an object by object Id. | ```
"objectId = 114"
``` |

### > Macro (anchor)

AQL syntax validation

The Assets app manages the AQL syntax validation and error messages. 

Once you provide an AQL query, to validate the syntax, click **Validate AQL Syntax.**

![image](media://f5e39db7-2404-4a83-bf06-dc75d4f19e0a)

> 📝 If you skip manually validating the AQL syntax, the form validation is performed with the click of **Continue**.

- If the AQL syntax is correct, then ✅ is displayed.
- If the AQL syntax is not correct, an error message is displayed. To proceed to the next step, provide valid AQL query syntax.

A few error messages are listed below based on the type of syntax errors.

| **Example** | **Query provided with invalid syntax** | **Error message** |
| --- | --- | --- |
| Limit the search result to a specific object schema name. | ```
objectSchema = 
``` | ![image](media://c6a9bb67-5ce1-47e8-92ad-2c764b72bd91) |
| Limit the search result on object schema ids. | ```
objectSchemaId in
``` | ![image](media://52a97f2a-94e3-4dd9-a573-da5b002f364c) |
| Limit the search result to a specific object type. | ```
objectType = "IT
``` | ![image](media://aea1bae2-f3fa-43ee-8703-9c407ffe48c0) |