BillPaymentCheck · Query
simulated in sandboxBillPaymentCheckQuery
A bill payment by check pays one or more open bills from a bank account. QuickBooks also has BillPaymentCreditCard for card-paid bills.
qbXML request
<?xml version="1.0" encoding="utf-8"?>
<?qbxml version="13.0"?>
<QBXML>
<QBXMLMsgsRq onError="stopOnError">
<BillPaymentCheckQueryRq requestID="1">
<MaxReturned>10</MaxReturned>
<ModifiedDateRangeFilter>
<FromModifiedDate>2026-10-01T00:00:00</FromModifiedDate>
</ModifiedDateRangeFilter>
</BillPaymentCheckQueryRq>
</QBXMLMsgsRq>
</QBXML>JSON equivalent
GET /v1/bill-payments?limit=10&updatedAfter=2026-10-01curl "https://ledgerwire.vibiz.app/v1/bill-payments?limit=10&updatedAfter=2026-10-01" \
-H "Authorization: Bearer $LEDGERWIRE_KEY"qbXML response (from the sandbox seed data)
<?xml version="1.0" ?>
<QBXML>
<QBXMLMsgsRs>
<BillPaymentCheckQueryRs requestID="1" statusCode="0" statusSeverity="Info" statusMessage="Status OK">
<BillPaymentCheckRet>
<TxnID>34E-1777159862</TxnID>
<TimeCreated>2026-04-25T23:31:02+00:00</TimeCreated>
<TimeModified>2026-04-25T23:31:02+00:00</TimeModified>
<EditSequence>1777159862</EditSequence>
<TxnNumber>9001</TxnNumber>
<PayeeEntityRef>
<ListID>80000083-1794871862</ListID>
<FullName>Prime Fleet Fuel</FullName>
</PayeeEntityRef>
<APAccountRef>
<ListID>80000007-1760311862</ListID>
<FullName>Accounts Payable</FullName>
</APAccountRef>
<TxnDate>2026-04-25</TxnDate>
<BankAccountRef>
<ListID>80000001-1760311862</ListID>
<FullName>Checking</FullName>
</BankAccountRef>
<IsToBePrinted>false</IsToBePrinted>
<RefNumber>4101</RefNumber>
<Amount>175.63</Amount>
<AppliedToTxnRet>
<TxnID>34C-1775431862</TxnID>
<TxnType>Bill</TxnType>
<TxnDate>2026-04-05</TxnDate>
<RefNumber>B-7002</RefNumber>
<BalanceRemaining>0.00</BalanceRemaining>
<Amount>175.63</Amount>
</AppliedToTxnRet>
</BillPaymentCheckRet>
</BillPaymentCheckQueryRs>
</QBXMLMsgsRs>
</QBXML>FAQ
How do I page through BillPaymentCheckQuery results?
In qbXML, add iterator="Start" to BillPaymentCheckQueryRq with MaxReturned, then send iterator="Continue" with the iteratorID until iteratorRemainingCount is 0. With LedgerWire, GET /v1/bill-payments?limit=100 and follow nextCursor.
How do I fetch only bill payment (check)s changed since my last sync?
Use ModifiedDateRangeFilter/FromModifiedDate inside BillPaymentCheckQueryRq, or updatedAfter on the REST endpoint.
Why does BillPaymentCheckQuery 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 BillPaymentCheckQuery 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.
More BillPaymentCheck messages
Skip the XML: call GET /v1/bill-payments with JSON.
Get a free sandbox key