Skip to main content
GET
/
quickbooks-desktop
/
deleted-list-objects
JavaScript
import Conductor from 'conductor-node';

const conductor = new Conductor({
  apiKey: process.env['CONDUCTOR_SECRET_KEY'], // This is the default and can be omitted
});

const deletedListObjects = await conductor.qbd.deletedListObjects.list({
  objectTypes: ['customer'],
  conductorEndUserId: 'end_usr_1234567abcdefg',
});

console.log(deletedListObjects.data);
{
  "objectType": "list",
  "url": "/v1/quickbooks-desktop/deleted-list-objects",
  "data": [
    {
      "listType": "customer",
      "id": "80000001-1234567890",
      "objectType": "qbd_deleted_list_object",
      "createdAt": "2025-01-01T12:34:56+00:00",
      "deletedAt": "2025-02-01T12:34:56+00:00"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Your Conductor secret key using Bearer auth (e.g., "Authorization: Bearer {{YOUR_SECRET_KEY}}").

Headers

​
Conductor-End-User-Id
string
required

The ID of the End-User to receive this request.

Example:

"end_usr_1234567abcdefg"

Query Parameters

​
objectTypes
enum<string>[]
required

Filter for deleted list-objects by their list-object type(s).

Available options:
account,
billing_rate,
class,
currency,
customer,
customer_message,
customer_type,
date_driven_terms,
employee,
inventory_site,
item_discount,
item_fixed_asset,
item_group,
item_inventory,
item_inventory_assembly,
item_non_inventory,
item_other_charge,
item_payment,
item_sales_tax,
item_sales_tax_group,
item_service,
item_subtotal,
job_type,
other_name,
payment_method,
payroll_item_non_wage,
payroll_item_wage,
price_level,
sales_representative,
sales_tax_code,
ship_method,
standard_terms,
to_do,
unit_of_measure_set,
vehicle,
vendor,
vendor_type,
workers_comp_code
Example:
["customer"]
​
deletedAfter
string

Filter for deleted list-objects deleted on or after this date/time, within the last 90 days (QuickBooks limit). Accepts the following ISO 8601 formats:

  • date-only (YYYY-MM-DD) - QuickBooks Desktop interprets the date as the start of the specified day in the local timezone of the end-user's computer (e.g., 2025-01-01 → 2025-01-01T00:00:00).
  • datetime without timezone (YYYY-MM-DDTHH:mm:ss) - QuickBooks Desktop interprets the timestamp in the local timezone of the end-user's computer.
  • datetime with timezone (YYYY-MM-DDTHH:mm:ss±HH:mm) - QuickBooks Desktop interprets the timestamp using the specified timezone.
Example:

"2025-01-01T12:34:56+00:00"

​
deletedBefore
string

Filter for deleted list-objects deleted on or before this date/time, within the last 90 days (QuickBooks limit). Accepts the following ISO 8601 formats:

  • date-only (YYYY-MM-DD) - QuickBooks Desktop interprets the date as the end of the specified day in the local timezone of the end-user's computer (e.g., 2025-01-01 → 2025-01-01T23:59:59).
  • datetime without timezone (YYYY-MM-DDTHH:mm:ss) - QuickBooks Desktop interprets the timestamp in the local timezone of the end-user's computer.
  • datetime with timezone (YYYY-MM-DDTHH:mm:ss±HH:mm) - QuickBooks Desktop interprets the timestamp using the specified timezone.
Example:

"2025-02-01T12:34:56+00:00"

Response

200 - application/json

Returns a list of deleted list-objects.

​
objectType
string
required

The type of object. This value is always "list".

Allowed value: "list"
Example:

"list"

​
url
string
required

The endpoint URL where this list can be accessed.

Example:

"/v1/quickbooks-desktop/deleted-list-objects"

​
data
The Deleted List-Object object · object[]
required

The array of deleted list-objects.