---
title: "Returns the status of the delete request"
method: GET
path: "/layers/{layerID}/deleteRequest/{deleteId}"
tags: ["index"]
---

# Returns the status of the delete request

`GET /layers/{layerID}/deleteRequest/{deleteId}`

Returns the details of the specified delete request. Delete request can be in one of the following states: Scheduled, Processing, Failed, Succeeded. See Data API Developer’s Guide in the Documentation section for the delete request state diagram.

## Path parameters

- `layerID` string, required
- `deleteId` string, required

## Response `200`

Delete request status

- DeleteRequestStatus
  - `deleteId` string, [0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}
  - `state` 'Scheduled' | 'Processing' | 'Failed' | 'Succeeded' — The state of the delete request. - `Scheduled` - The delete request was successfully scheduled. - `Processing` - The delete request is being executed. - `Failed` - The delete request failed. Please try again. - `Succeeded` - The delete request finished successfully. The number of deleted records is provided in the `count` field.
  - `message` string — A message describing the state.
  - `count` integer — Number of deleted index records.

## Other responses

- `400` — Bad Request - The request is invalid. Verify and retry.
- `401` — Unauthorized - The credentials provided do not authorize the user to perform this operation.
- `403` — Forbidden - The user is not authorized to perform the operation on the resource specified.
- `404` — Not Found - The criteria set in the request are not valid.

---

[API](https://skmtc.dev/here/apis/query-api-v1.md) · [All operations](https://skmtc.dev/here/apis/query-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/here/query-api-v1/revisions/30e5d2645407/schema)