> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://zuora.ferndocs.com/docs/platform/data/aggregate-query-api-aqua/stateless-and-stateful-modes/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://zuora.ferndocs.com/_mcp/server.

# AQuA: Stateless and stateful modes

> The Aggregate Query API (AQuA) offers stateless and stateful modes for executing queries, with recommendations for usage based on data extraction needs.

The Aggregate Query API (AQuA) offers stateless and stateful modes for executing queries, with recommendations for usage based on data extraction needs.

The Aggregate Query API (AQuA) supports two execution modes: stateless and stateful.

* Stateless mode executes each query independently without maintaining a session.
* Stateful mode maintains a continuous session across multiple calls, allowing incremental data extraction.

  > **Note**
  >
  > Zuora strongly recommends using stateless mode for most bulk data extractions. For continuous integrations that require incremental data loads, use stateful mode. See [Bulk Data Extraction from Zuora using AQuA](/docs/platform/data/aggregate-query-api-aqua/bulk-data-extraction-from-zuora-using-aqua) for more information.

The AQuA Job Finder enables you to view all AQuA requests and results executed on your tenant within the last 72 hours. Older results are automatically purged. Excessive usage of full, non-stateful queries is discouraged; use stateful AQuA for recurring, incremental data extractions.

> The Aggregate Query API (AQuA) offers stateless and stateful modes for executing queries, with recommendations for usage based on data extraction needs.

## Docs

- [Stateless and stateful modes](https://zuora.ferndocs.com/docs/platform/data/aggregate-query-api-aqua/stateless-and-stateful-modes/stateless-and-stateful-modes-part-2.md): AQuA can operate in stateless and stateful modes, executing queries either sequentially or within a continuous session.
- [Automatic switch between full load and incremental load](https://zuora.ferndocs.com/docs/platform/data/aggregate-query-api-aqua/stateless-and-stateful-modes/automatic-switch-between-full-load-and-incremental-load.md): AQuA automatically switches between full and incremental data loads based on session identifiers and query changes.
- [Time offset for AQuA stateful queries](https://zuora.ferndocs.com/docs/platform/data/aggregate-query-api-aqua/stateless-and-stateful-modes/time-offset-for-aqua-stateful-queries.md): Learn how to configure a time offset for AQuA stateful queries to control the data retrieval interval.
- [Examples: Data retrieval](https://zuora.ferndocs.com/docs/platform/data/aggregate-query-api-aqua/stateless-and-stateful-modes/examples.md): Learn how to use AQuA queries to retrieve data from custom fields and deleted records for enhanced integration.