---
title: "GET /jobs/deletions"
method: GET
path: "/jobs/deletions"
tags: ["Jobs"]
---

# GET /jobs/deletions

`GET /jobs/deletions`

Retrieves all deletion jobs. This may be useful to find a delete job that was previously requested, or to view a history of delete jobs that have run or are currently running on the instance.
Status codes:
* 200 OK

## Query parameters

- `api-version` string, required

## Headers

- `max-items-per-page` integer

## Response `200`

Success

- DeleteJobCollection — A collection of delete job objects.
  - `value` DeleteJob[], required — The list of delete job objects.
    - `id` string — The identifier of the delete job.
    - `status` 'notstarted' | 'running' | 'failed' | 'succeeded' — Status of the job.
    - `createdDateTime` string, date-time — Start time of the job. The timestamp is in RFC3339 format: `yyyy-MM-ddTHH:mm:ssZ`.
    - `finishedDateTime` string, date-time — End time of the job. The timestamp is in RFC3339 format: `yyyy-MM-ddTHH:mm:ssZ`.
    - `purgeDateTime` string, date-time — Time at which job will be purged by the service from the system. The timestamp is in RFC3339 format: `yyyy-MM-ddTHH:mm:ssZ`.
    - `error` Error — Error definition.
      - `code` string — Service specific error code which serves as the substatus for the HTTP error code.
      - `message` string — A human-readable representation of the error.
      - `details` Error[] — Internal error details.
      - `innererror` InnerError — A more specific error description than was provided by the containing error.
        - `code` string — A more specific error code than was provided by the containing error.
        - `innererror` InnerError — recursive
  - `nextLink` string — A URI to retrieve the next page of results.

## Other responses

- `default` — Default response.

---

[API](https://skmtc.net/azure/apis/digitaltwins-digitaltwins.md) · [All operations](https://skmtc.net/azure/apis/digitaltwins-digitaltwins/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/digitaltwins-digitaltwins/revisions/8d81dcdaf9a2/schema)