---
title: SearchQueryExpressionPayload type | Wartiva GraphQL API
description: Output mirror of SearchQueryExpressionInput, echoing a structured where clause back on GraphSearchQueryInputPayload.
url: https://wartiva.com/api-docs/types/search-query-expression-payload.html
updated: 2026-10-07
---

Graph search · GraphQL type

# `SearchQueryExpressionPayload` type

Output mirror of [SearchQueryExpressionInput](https://wartiva.com/api-docs/types/search-query-expression-input.html), echoing a structured where clause back on [GraphSearchQueryInputPayload](https://wartiva.com/api-docs/types/graph-search-query-input-payload.html). GraphQL cannot return an input type, so the shape is duplicated rather than shared.

It mirrors what the caller supplied, not what validation resolved: there is no keyType or multiKey, and keys appear in the casing they were sent in. A client can therefore take a search job's requested input and resubmit it unchanged.

The resolved tree — case-corrected keys, field types, multi-key flags — is available only from [graphParseQuery](https://wartiva.com/api-docs/queries/graph-parse-query.html), which returns the [SearchQueryExpression](https://wartiva.com/api-docs/types/search-query-expression.html) interface types. It parses a where-clause STRING and has no structured-expression input, so that route is open only to a client holding the string encoding; there is no resolution path for an expression this payload echoed back.

## Fields

| Field Name | Description |
|---|---|
| `expressionType` - [`SearchQueryExpressionType!`](https://wartiva.com/api-docs/types/search-query-expression-type.html) | Names which variant field below carries this node. |
| `operatorExpression` - [`SearchQueryOperatorExpressionPayload`](https://wartiva.com/api-docs/types/search-query-operator-expression-payload.html) | The node when expressionType is OPERATOR. |
| `keyValue` - [`SearchQueryMatchKeyValueExpressionPayload`](https://wartiva.com/api-docs/types/search-query-match-key-value-expression-payload.html) | The node when expressionType is KEY_VALUE. |
| `keyValueNumeric` - [`SearchQueryMatchKeyValueNumericExpressionPayload`](https://wartiva.com/api-docs/types/search-query-match-key-value-numeric-expression-payload.html) | The node when expressionType is KEY_VALUE_NUMERIC. |
| `keyValueTime` - [`SearchQueryMatchKeyValueTimeExpressionPayload`](https://wartiva.com/api-docs/types/search-query-match-key-value-time-expression-payload.html) | The node when expressionType is KEY_VALUE_TIME. |
| `keyValueBoolean` - [`SearchQueryMatchKeyValueBooleanExpressionPayload`](https://wartiva.com/api-docs/types/search-query-match-key-value-boolean-expression-payload.html) | The node when expressionType is KEY_VALUE_BOOLEAN. |
| `keyValueFullText` - [`SearchQueryMatchTextExpressionPayload`](https://wartiva.com/api-docs/types/search-query-match-text-expression-payload.html) | The node when expressionType is KEY_VALUE_FULL_TEXT. |
| `keyNull` - [`SearchQueryMatchKeyNullExpressionPayload`](https://wartiva.com/api-docs/types/search-query-match-key-null-expression-payload.html) | The node when expressionType is KEY_NULL. |

## Used by

- [`GraphSearchQueryInputPayload`](https://wartiva.com/api-docs/types/graph-search-query-input-payload.html) type: Output mirror of GraphSearchQueryInput used when an executed query is returned as a field on another type (for example as part of a…
- [`SearchQueryOperatorExpressionPayload`](https://wartiva.com/api-docs/types/search-query-operator-expression-payload.html) type: An AND/OR node over sub-expressions: the output mirror of SearchQueryOperatorExpressionInput.

## Example

### Example

```json
{
  "expressionType": "OPERATOR",
  "operatorExpression": SearchQueryOperatorExpressionPayload,
  "keyValue": SearchQueryMatchKeyValueExpressionPayload,
  "keyValueNumeric": SearchQueryMatchKeyValueNumericExpressionPayload,
  "keyValueTime": SearchQueryMatchKeyValueTimeExpressionPayload,
  "keyValueBoolean": SearchQueryMatchKeyValueBooleanExpressionPayload,
  "keyValueFullText": SearchQueryMatchTextExpressionPayload,
  "keyNull": SearchQueryMatchKeyNullExpressionPayload
}

```

---

Wartiva is in early access. Request access: https://wartiva.com/early-access.html  
All pages: https://wartiva.com/llms.txt