A ListID is unique within its list family, not within one list or across the file - customers, vendors, employees and other names share one sequence, every item type another, each other list its own - so records in two families can hold the same ListID

Observed 2026-10-25 on QuickBooks Enterprise Solutions 24.0 (US), reporting qbXML 17.0.

A ListID is unique within a list family, not within one list and not across the company file. Customers, vendors and employees draw from one sequence, every item type draws from another, and accounts and classes each count on their own. A ListID is a counter followed by the creation time in Unix seconds, so records in two families can share a counter, and two created in the same second would share the whole ListID. Intuit's reference says only that a customer cannot share a ListID with an employee, both being name lists, but could share one with a non-inventory item.

In one company file, counter 80000003 belongs to a customer, a sales tax item, an account and a class:

qbXML
<CustomerRet><ListID>80000003-1665678791</ListID></CustomerRet>
<ItemSalesTaxRet><ListID>80000003-1665678096</ListID></ItemSalesTaxRet>
<AccountRet><ListID>80000003-1665676686</ListID></AccountRet>
<ClassRet><ListID>80000001-1780535846</ListID></ClassRet>
<ClassRet><ListID>80000003-1789791998</ListID></ClassRet>

Among the names, vendors hold 80000001, 80000002 and 80000005, customers 80000003 and 80000004, and the employee 8000000C, with no counter repeated. A customer's ListID sent to another family's query is not found there:

qbXML
<VendorQueryRs statusCode="500" statusSeverity="Warn" statusMessage="The query request has not been fully completed. There was a required element (&quot;80000020-1790716232&quot;) that could not be found in QuickBooks." />
<EmployeeQueryRs statusCode="500" statusSeverity="Warn" statusMessage="The query request has not been fully completed. There was a required element (&quot;80000020-1790716232&quot;) that could not be found in QuickBooks." />
<ItemQueryRs statusCode="500" statusSeverity="Warn" statusMessage="The query request has not been fully completed. There was a required element (&quot;80000020-1790716232&quot;) that could not be found in QuickBooks." />

What to do

Never store or look up a ListID on its own. Key it by company file and by the list it came from, and send it only to that list's query. Keying by list is finer than keying by family, so it never matches across families.

Not observed

  • Whether TxnID values share one sequence across transaction types.
  • Whether an item keeps its ListID when its type is converted.
  • Terms, customer and vendor types, sales tax codes and price levels were not queried.

Error codes on this page

QuBe Sync is a JSON API for QuickBooks Desktop that is built on what these findings show.