---
title: "List all deleted list-objects"
method: GET
path: "/quickbooks-desktop/deleted-list-objects"
---

# List all deleted list-objects

`GET /quickbooks-desktop/deleted-list-objects`

Lists deleted non-transaction list-objects (e.g., customers, vendors, employees, items) from the last 90 days. Results are grouped by list-object type and ordered by actual delete time (ascending). For deleted transactions (e.g., invoices, bills, estimates), see the deleted-transactions endpoint.

**NOTE:** QuickBooks Desktop does not support pagination for deleted list-objects; hence, there is no `cursor` parameter. Users typically have few deleted list-objects.

## Query parameters

- `objectTypes` string[], required — Filter for deleted list-objects by their list-object type(s).
- `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.
- `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.

## Headers

- `Conductor-End-User-Id` string, required — The ID of the End-User to receive this request.

## Response `200`

Returns a list of deleted list-objects.

- object
  - `objectType` 'list', required — The type of object. This value is always `"list"`.
  - `url` string, required — The endpoint URL where this list can be accessed.
  - `data` QbdDeletedListObject[], required — The array of deleted list-objects.
    - `listType` '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', required — The type of deleted list object (i.e., non-transaction).
    - `id` string, required — The unique identifier assigned by QuickBooks to this deleted list-object. This ID is unique across all deleted list-objects but not across different QuickBooks object types.
    - `objectType` 'qbd_deleted_list_object', required — The type of object. This value is always `"qbd_deleted_list_object"`.
    - `createdAt` string, required — The date and time when this deleted list-object was created, in ISO 8601 format (YYYY-MM-DDThh:mm:ss±hh:mm), which QuickBooks Desktop interprets in the local timezone of the end-user's computer.
    - `deletedAt` string, required — The date and time when this deleted list-object was deleted, in ISO 8601 format (YYYY-MM-DDThh:mm:ss±hh:mm), which QuickBooks Desktop interprets in the local timezone of the end-user's computer.
    - `fullName` string, nullable, required — The case-insensitive fully-qualified unique name of this deleted list-object, formed by combining the names of its hierarchical parent objects with its own `name`, separated by colons. For example, if a deleted list-object is under "Parent" and has the `name` "Child", its `fullName` would be "Parent:Child". **NOTE**: Unlike `name`, `fullName` is guaranteed to be unique across all deleted list-object objects. However, `fullName` can still be arbitrarily changed by the QuickBooks user when they modify the underlying `name` field.

---

[API](https://skmtc.net/conductor-is/apis/conductor-api.md) · [All operations](https://skmtc.net/conductor-is/apis/conductor-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/conductor-is/conductor-api/versions/0b07b3ebe160/schema)