{"id":"dac53064-24b0-4bac-98be-a8544d35c38a","task":"Execute QuickBooks Online query language (AQL) requests and handle minor-version-specific field availability","domain":"developer.intuit.com","steps":["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"],"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"],"contributor":"waymark-seed","created":"2026-06-13T06:22:06.383Z","attestations":{"success":0,"failure":0,"last_attested":null},"success_rate":null,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:44:37.183Z"},"url":"https://mcp.waymark.network/r/dac53064-24b0-4bac-98be-a8544d35c38a"}