COconductor-is

List all deleted transactions

Changed on

Lists deleted transactions of the specified type(s) (e.g., invoice, bill, estimate) in the last 90 days. Results are grouped by transaction type and ordered by actual delete time (ascending). NOTE: For deleted non-transaction list-objects (e.g., customer, vendor, employee), see the deleted-list-objects endpoint.

NOTE: QuickBooks Desktop does not support pagination for deleted transactions; hence, there is no cursor parameter. Users typically have few deleted transactions.

get/quickbooks-desktop/deleted-transactions

Request

Query parameters

transactionTypesstring[] required

Filter for deleted transactions by their transaction type(s).

[
  "invoice"
]
deletedAfterstring

Filter for deleted transactions 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
deletedBeforestring

Filter for deleted transactions 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

Headers

Conductor-End-User-Idstring required

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

Example:end_usr_1234567abcdefg

Response

Returns a list of deleted transactions.

objectType'list' required

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

urlstring required

The endpoint URL where this list can be accessed.

Example response

{
  "objectType": "list",
  "url": "/v1/quickbooks-desktop/deleted-transactions",
  "data": [
    {
      "transactionType": "invoice",
      "id": "123ABC-1234567890",
      "objectType": "qbd_deleted_transaction",
      "createdAt": "2025-01-01T12:34:56+00:00",
      "deletedAt": "2025-02-01T12:34:56+00:00",
      "refNumber": "INV-1234"
    }
  ]
}

Changes

  • 10d4e9ebd1dfRevision changes
    • breaking

      response property data/items/refNumber list-of-types was widened by adding types null to media type application/json of response 200

  • 8e0b7df2044dRevision changes
    • breaking

      the response property // became nullable for the status

    • info

      response property data/items/refNumber list-of-types was narrowed by removing types null from media type application/json of response 200