Warehouse / Guides

Search queries

Filter lists with the query argument.

Basic syntax

Operations that accept a query argument list their supported fields in the reference. Pass the search expression as a GraphQL variable.

query Orders($query: String!, $first: Int!) {
orders(query: $query, first: $first) {
edges { node { id reference } }
}
}
{
"query": "reference:PC-100*",
"first": 25
}

Operators

field:valueExact match
field:>valueGreater than; also supports <, >= and <=
field:prefix*Starts with a value
field:*Field or relation exists
-field:valueNegate a term; NOT field:value is equivalent
a:1 AND b:2Combine terms; OR is also supported

AND, OR and NOT are uppercase. When you combine AND and OR, use parentheses and keep one connective inside each group.

Values with spaces

Wrap values containing spaces in single or double quotes, for example name:"North Dock". Supported fields and value formats differ per operation; use the filter table shown beside itsquery argument.