{
  "ListID": "800000AB-1234567890",
  "Name": "SUNNY GARDENS INC.",
  "FullName": "SUNNY GARDENS INC.",
  "CompanyName": "SUNNY GARDENS INC.",
  "Phone": "555-987-6543",
  "AltPhone": "800-246-1357",
  "Fax": "555-123-4567",
  "Email": "info@sunnygardens.com",
  "IsActive": true,
  "Balance": "5678.92",
  "TotalBalance": "5678.92",
  "TimeCreated": "2021-09-15T14:30:00-05:00",
  "TimeModified": "2023-09-01T09:45:12-05:00",
  "EditSequence": "1987654321",
  "CustomerTypeRef": {
    "ListID": "8000000F-1234567890",
    "FullName": "Wholesale"
  },
  "PriceLevelRef": {
    "ListID": "80000003-1234567890",
    "FullName": "WHOLESALE PRICE LEVEL LIST"
  },
  "SalesTaxCodeRef": {
    "ListID": "80000003-1234567890",
    "FullName": "Taxable"
  },
  "TermsRef": {
    "ListID": "80000007-1234567890",
    "FullName": "Net 60"
  },
  "BillAddress": {
    "Addr1": "SUNNY GARDENS INC.",
    "Addr2": "4321 MAIN STREET",
    "City": "SPRINGFIELD, IL 62701 US, IL 62",
    "State": "IL 62701 US"
  },
  "BillAddressBlock": {
    "Addr1": "SUNNY GARDENS INC.",
    "Addr2": "4321 MAIN STREET",
    "Addr3": "SPRINGFIELD, IL 62701 US, IL 62701"
  },
  "ShipAddress": {
    "Addr1": "SUNNY GARDENS INC.",
    "Addr2": "4321 MAIN STREET",
    "City": "SPRINGFIELD",
    "State": "IL",
    "PostalCode": "62701",
    "Country": "United States"
  },
  "ShipAddressBlock": {
    "Addr1": "SUNNY GARDENS INC.",
    "Addr2": "4321 MAIN STREET",
    "Addr3": "SPRINGFIELD, IL 62701",
    "Addr4": "United States"
  },
  "Sublevel": 0,
  "JobStatus": "None",
  "Notes": "John Smith - Owner\\nMary Smith - Manager"
}

{
  "ListID": "8000000D-1987654321",
  "TimeCreated": "2022-03-01T10:15:00-05:00",
  "TimeModified": "2023-09-01T14:30:00-05:00",
  "EditSequence": 1987654322,
  "Name": "Spring Planting",
  // For jobs, `FullName` is the concatenation of the
  // parent customer's `FullName` and the job's `Name`.
  "FullName": "SUNNY GARDENS INC.:Spring Planting",
  "IsActive": true,
  // `ParentRef` only exists for jobs and points to
  // the parent customer object.
  "ParentRef": {
    "ListID": "800000AB-1234567890",
    "FullName": "SUNNY GARDENS INC."
  },
  "Sublevel": 1,
  "Balance": 1234.56,
  "TotalBalance": 1234.56,
  "JobStatus": "In Progress",
  "PreferredDeliveryMethod": "Email",
  "StartDate": "2022-03-15",
  "ProjectedEndDate": "2022-05-31",
  "JobTypeRef": {
    "ListID": "8000000G-1987654321",
    "FullName": "Landscaping"
  },
  "JobDescription": "Annual spring planting and garden setup for Sunny Gardens Inc.",
  "PrimaryContactRef": {
    "ListID": "8000000H-1987654321",
    "FullName": "Mary Smith"
  }
}

In QuickBooks Desktop, an end-user’s “customers” and the individual “jobs” the end-user performs for their customers are both represented as Customer objects. “Jobs” are considered a subset of “customers” but cannot be fetched separately. This is the nature of QuickBooks Desktop and is out of Conductor’s control.

A job differs from a customer in two ways:

  1. It has a ParentRef property that points to the parent customer.

  2. Its FullName property is the concatenation of the parent customer’s FullName and the job’s Name.

    • For example, if the parent customer’s FullName is "Annie's Alligators" and the job’s Name is "Swamp", the job’s FullName will be "Annie's Alligators:Swamp".

For example, the following query fetches all customers and jobs for a given end-user:

Fetching all customers and jobs
const customersAndJobs = await conductor.qbd.customer.query("{{END_USER_ID}}");

To see all of the request parameters and response fields for , check out our client library’s amazing autocomplete.

QuickBooks Desktop integration tipsVendors