CustomerQuery qbXML example
Reads customers and jobs: the active ones changed since a date, a page at a time.
qbXML
CustomerQueryRq, version 16.0
<?xml version="1.0" encoding="utf-8"?>
<?qbxml version="16.0"?>
<QBXML>
<QBXMLMsgsRq onError="stopOnError">
<CustomerQueryRq iterator="Start">
<MaxReturned>100</MaxReturned>
<ActiveStatus>ActiveOnly</ActiveStatus>
<FromModifiedDate>2026-01-01T00:00:00-06:00</FromModifiedDate>
</CustomerQueryRq>
</QBXMLMsgsRq>
</QBXML>
Open in the validator
Check it against the qbXML 16.0 schema, edit it, and run it in your own QuickBooks.
Things to know
- Page large results: iterator="Start" with MaxReturned on the first request, then iterator="Continue" with the iteratorID from the answer.
- TimeModified is the company's local time with its standard-time offset all year. Send a record's TimeModified back as FromModifiedDate unchanged and the filter finds it.
- An iterator can't be combined with a ListID or FullName lookup: QuickBooks answers 3150 for the missing MaxReturned, which the schema doesn't allow beside an id.
The same request with QuBe Sync's API
QuBe Sync takes these parameters, writes the qbXML for you and delivers QuickBooks' answer to your webhook as JSON.
GET
/api/v2/connections/{connection_id}/customers
?active_status=ActiveOnly
&from_modified_date=2026-01-01T00:00:00-06:00
&iterator=true
&max_returned=100
Every field CustomerQuery takes is in Intuit's reference.
More requests
Customers and sales