Vendor · Query
simulated in sandboxVendorQuery
Vendors are who you buy from: suppliers, landlords, utilities and contractors. Bills and bill payments point at a vendor through VendorRef or PayeeEntityRef.
qbXML request
<?xml version="1.0" encoding="utf-8"?>
<?qbxml version="13.0"?>
<QBXML>
<QBXMLMsgsRq onError="stopOnError">
<VendorQueryRq requestID="1">
<MaxReturned>10</MaxReturned>
<ActiveStatus>ActiveOnly</ActiveStatus>
<FromModifiedDate>2026-10-01T00:00:00</FromModifiedDate>
</VendorQueryRq>
</QBXMLMsgsRq>
</QBXML>JSON equivalent
GET /v1/vendors?limit=10&updatedAfter=2026-10-01curl "https://ledgerwire.vibiz.app/v1/vendors?limit=10&updatedAfter=2026-10-01" \
-H "Authorization: Bearer $LEDGERWIRE_KEY"qbXML response (from the sandbox seed data)
<?xml version="1.0" ?>
<QBXML>
<QBXMLMsgsRs>
<VendorQueryRs requestID="1" statusCode="0" statusSeverity="Info" statusMessage="Status OK">
<VendorRet>
<ListID>8000007D-1794881749</ListID>
<TimeCreated>2025-11-07T00:23:19+00:00</TimeCreated>
<TimeModified>2025-11-07T00:23:19+00:00</TimeModified>
<EditSequence>1762474999</EditSequence>
<Name>Ferguson Supply Partners</Name>
<IsActive>true</IsActive>
<CompanyName>Ferguson Supply Partners</CompanyName>
<VendorAddress>
<Addr1>Ferguson Supply Partners</Addr1>
<Addr2>1510 River Rd</Addr2>
<City>Tulsa</City>
<State>OK</State>
<PostalCode>74103</PostalCode>
</VendorAddress>
<Phone>(900) 555-4986</Phone>
<NameOnCheck>Ferguson Supply Partners</NameOnCheck>
<TermsRef>
<FullName>Net 30</FullName>
</TermsRef>
<Balance>0.00</Balance>
</VendorRet>
</VendorQueryRs>
</QBXMLMsgsRs>
</QBXML>FAQ
How do I page through VendorQuery results?
In qbXML, add iterator="Start" to VendorQueryRq with MaxReturned, then send iterator="Continue" with the iteratorID until iteratorRemainingCount is 0. With LedgerWire, GET /v1/vendors?limit=100 and follow nextCursor.
How do I fetch only vendors changed since my last sync?
Use FromModifiedDate inside VendorQueryRq, or updatedAfter=2026-10-01T00:00:00Z on the REST endpoint.
Why does VendorQuery return statusCode 1?
Status 1 is informational: "A query request did not find a matching object in QuickBooks". The request was valid and nothing matched the filters. LedgerWire returns an empty data array for it.
Sandbox fidelity
The LedgerWire sandbox simulates VendorQuery with QuickBooks rules: required fields, element names, refs that must exist (3140), unique names (3100), field lengths (3070) and EditSequence locking (3200). Tax calculation, custom fields and preferences are not simulated.
Skip the XML: call GET /v1/vendors with JSON.
Get a free sandbox key