A NameFilter compares with the record's full name, so Contains "foobar:a" finds the job "foobar:a job for foobar", and it ignores case

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

A NameFilter on CustomerQueryRq compares its Name with the record's FullName, parents included, not only with the record's own Name. It also ignores case.

The file has a job whose Name is a job for foobar and whose FullName is foobar:a job for foobar:

qbXML
<CustomerQueryRq>
  <ActiveStatus>All</ActiveStatus>
  <NameFilter>
    <MatchCriterion>Contains</MatchCriterion>
    <Name>foobar:a</Name>
  </NameFilter>
</CustomerQueryRq>

QuickBooks answered status 0 with the job foobar:a job for foobar. The text foobar:a appears only in the job's full name, so the filter compares with the full name. Contains BOB answered all three customers whose names start with "Bob", one of them inactive.

What to do

When you search for near matches with a NameFilter, expect jobs and other child records whose parent's name holds the text, and tell them apart by FullName or by their parent. Do not rely on the filter's case: BOB and Bob match the same records.

Not observed

  • StartsWith and EndsWith, which may also compare with the full name.
  • NameRangeFilter.
  • Lists other than customers.

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