Append the minorversion query parameter to all API requests to target a stable, documented API minor version
Construct a SELECT statement using QBO AQL syntax, specifying entity, fields, WHERE clauses, ORDERBY, and STARTPOSITION/MAXRESULTS for pagination
URL-encode the query string and issue it as a GET request to the /query endpoint
Check the QueryResponse totalCount against the MAXRESULTS page size to determine whether additional pages exist
Iterate through pages by incrementing STARTPOSITION by the page size until all records are retrieved
Validate that fields used in WHERE clauses are filterable for the targeted minor version, consulting the entity schema in the docs
Known gotchas
Certain fields only become queryable or filterable at specific minor versions; using a field against an older minor version returns a query fault rather than silently ignoring it
MAXRESULTS is capped at 1000 per request; attempting larger values results in an error, not a silent truncation
AQL does not support JOINs; related entity data must be fetched with separate queries using the foreign key Ids returned in the first query
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp