--- title: Gets a list of data deletion requests description: Datadog, the leading service for cloud-scale monitoring. breadcrumbs: Docs > API Reference > Data Deletion --- > For the complete documentation index, see [llms.txt](https://docs.datadoghq.com/llms.txt). # Gets a list of data deletion requests{% #gets-a-list-of-data-deletion-requests %} {% tab title="v2" %} | Datadog site | API endpoint | | ----------------- | ---------------------------------------------------------- | | ap1.datadoghq.com | GET https://api.ap1.datadoghq.com/api/v2/deletion/requests | | ap2.datadoghq.com | GET https://api.ap2.datadoghq.com/api/v2/deletion/requests | | app.datadoghq.eu | GET https://api.datadoghq.eu/api/v2/deletion/requests | | app.ddog-gov.com | GET https://api.ddog-gov.com/api/v2/deletion/requests | | us2.ddog-gov.com | GET https://api.us2.ddog-gov.com/api/v2/deletion/requests | | uk1.datadoghq.com | GET https://api.uk1.datadoghq.com/api/v2/deletion/requests | | app.datadoghq.com | GET https://api.datadoghq.com/api/v2/deletion/requests | | us3.datadoghq.com | GET https://api.us3.datadoghq.com/api/v2/deletion/requests | | us5.datadoghq.com | GET https://api.us5.datadoghq.com/api/v2/deletion/requests | ### Overview Gets a list of data deletion requests based on several filter parameters. This endpoint requires the `logs_delete_data` permission. ### Arguments #### Query Strings | Name | Type | Description | | --------- | ------- | ------------------------------------------------------------------------------------------------------------------------- | | next_page | string | The next page of the previous search. If the next_page parameter is included, the rest of the query elements are ignored. | | product | string | Retrieve only the requests related to the given product. | | query | string | Retrieve only the requests that matches the given query. | | status | string | Retrieve only the requests with the given status. | | page_size | integer | Sets the page size of the search. | ### Response {% tab title="200" %} OK {% tab title="Model" %} The response from the get data deletion requests endpoint. | Parent field | Field | Type | Description | | -------------------- | ------------------------------------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | | data | [object] | The list of data deletion requests that matches the query. | | data | attributes [*required*] | object | Deletion attribute for data deletion response. | | attributes | created_at [*required*] | string | Creation time of the deletion request. | | attributes | created_by [*required*] | string | User who created the deletion request. | | attributes | customer_message | string | A message for the customer regarding the deletion request, if any. | | attributes | displayed_total [*required*] | int64 | Total number of elements to be deleted as displayed to the user. | | attributes | error_category | string | The category of the error for the deletion request, if any. | | attributes | from_time [*required*] | int64 | Start of requested time window, milliseconds since Unix epoch. | | attributes | indexes | [string] | List of indexes for the search. If not provided, the search is performed in all indexes. | | attributes | is_created [*required*] | boolean | Whether the deletion request is fully created or not. It can take several minutes to fully create a deletion request depending on the target query and timeframe. | | attributes | org_id [*required*] | int64 | Organization ID. | | attributes | product [*required*] | string | Product name. | | attributes | query [*required*] | string | Query for creating a data deletion request. | | attributes | recoverable_until | string | Time when the recovery period for the deletion request ends. Before this time, you can cancel the request and recover the data. After this time, permanent deletion begins, and the status changes to `deleting` within a few minutes. This field is returned only for `in_progress` requests when listing deletion requests, and is omitted if the value cannot be determined. | | attributes | source | string | The source of the deletion request. | | attributes | starting_at [*required*] | string | Starting time of the process to delete the requested data. | | attributes | status [*required*] | string | Status of the deletion request. | | attributes | to_time [*required*] | int64 | End of requested time window, milliseconds since Unix epoch. | | attributes | total_unrestricted [*required*] | int64 | Total number of elements to be deleted. Only the data accessible to the current user that matches the query and timeframe provided will be deleted. | | attributes | updated_at [*required*] | string | Update time of the deletion request. | | data | id [*required*] | string | The ID of the created data deletion request. | | data | type [*required*] | string | The type of the request created. | | | meta | object | The metadata of the data deletion response. | | meta | available_slots | int64 | Number of additional deletion requests the current organization can create before reaching the concurrency limit. Requests with a `pending`, `in_progress`, or `deleting` status count toward the limit. This field is returned only when listing deletion requests, and is omitted if the value cannot be determined. | | meta | count_product | object | The total deletion requests created by product. | | additionalProperties | | int64 | | meta | count_status | object | The total deletion requests created by status. | | additionalProperties | | int64 | | meta | max_concurrent_requests | int64 | Maximum number of deletion requests with a `pending`, `in_progress`, or `deleting` status that the current organization can have at the same time. This field is returned only when listing deletion requests, and is omitted if the value cannot be determined. | | meta | next_page | string | The next page when searching deletion requests created in the current organization. | | meta | product | string | The product of the deletion request. | | meta | request_status | string | The status of the executed request. | {% /tab %} {% tab title="Example" %} ```json { "data": [ { "attributes": { "created_at": "2024-01-01T00:00:00.000000Z", "created_by": "test.user@datadoghq.com", "customer_message": "Your deletion request is being processed.", "displayed_total": 100, "error_category": "validation_error", "from_time": 1672527600000, "indexes": [ "test-index", "test-index-2" ], "is_created": true, "org_id": 321813, "product": "logs", "query": "service:xyz host:abc", "recoverable_until": "2024-01-11T02:00:00.000000Z", "source": "standard", "starting_at": "2024-01-01T02:00:00.000000Z", "status": "pending", "to_time": 1704063600000, "total_unrestricted": 100, "updated_at": "2024-01-01T00:00:00.000000Z" }, "id": "1", "type": "deletion_request" } ], "meta": { "available_slots": 3, "count_product": { "": "integer" }, "count_status": { "": "integer" }, "max_concurrent_requests": 5, "next_page": "cGFnZTI=", "product": "logs", "request_status": "canceled" } } ``` {% /tab %} {% /tab %} {% tab title="400" %} Bad Request {% tab title="Model" %} API error response. | Field | Type | Description | | ------------------------ | -------- | ----------------- | | errors [*required*] | [string] | A list of errors. | {% /tab %} {% tab title="Example" %} ```json { "errors": [ "Bad Request" ] } ``` {% /tab %} {% /tab %} {% tab title="403" %} Forbidden {% tab title="Model" %} API error response. | Field | Type | Description | | ------------------------ | -------- | ----------------- | | errors [*required*] | [string] | A list of errors. | {% /tab %} {% tab title="Example" %} ```json { "errors": [ "Bad Request" ] } ``` {% /tab %} {% /tab %} {% tab title="429" %} Too many requests {% tab title="Model" %} API error response. | Field | Type | Description | | ------------------------ | -------- | ----------------- | | errors [*required*] | [string] | A list of errors. | {% /tab %} {% tab title="Example" %} ```json { "errors": [ "Bad Request" ] } ``` {% /tab %} {% /tab %} {% tab title="500" %} Internal server error {% tab title="Model" %} API error response. | Field | Type | Description | | ------------------------ | -------- | ----------------- | | errors [*required*] | [string] | A list of errors. | {% /tab %} {% tab title="Example" %} ```json { "errors": [ "Bad Request" ] } ``` {% /tab %} {% /tab %} ### Code Example ##### \# Use a Personal Access Token or Service Access Token export DD_BEARER_TOKEN="" \# Curl command curl -X GET "https://api.datadoghq.com/api/v2/deletion/requests" \ -H "Accept: application/json" \ -H "Authorization: Bearer ${DD_BEARER_TOKEN}" ##### ```python """ Gets a list of data deletion requests returns "OK" response """ from os import environ from datadog_api_client import ApiClient, Configuration from datadog_api_client.v2.api.data_deletion_api import DataDeletionApi configuration = Configuration() configuration.access_token = environ["DD_BEARER_TOKEN"] with ApiClient(configuration) as api_client: api_instance = DataDeletionApi(api_client) response = api_instance.get_data_deletion_requests() print(response) ``` #### Instructions First [install the library and its dependencies](https://docs.datadoghq.com/api/latest.md?code-lang=python) and then save the example to `example.py` and run following commands: DD_SITE="datadoghq.com" DD_BEARER_TOKEN="" python3 "example.py" ##### ```ruby # Gets a list of data deletion requests returns "OK" response require "datadog_api_client" DatadogAPIClient.configure do |config| config.access_token = ENV["DD_BEARER_TOKEN"] end api_instance = DatadogAPIClient::V2::DataDeletionAPI.new p api_instance.get_data_deletion_requests() ``` #### Instructions First [install the library and its dependencies](https://docs.datadoghq.com/api/latest.md?code-lang=ruby) and then save the example to `example.rb` and run following commands: DD_SITE="datadoghq.com" DD_BEARER_TOKEN="" rb "example.rb" ##### ```go // Gets a list of data deletion requests returns "OK" response package main import ( "context" "encoding/json" "fmt" "os" "github.com/DataDog/datadog-api-client-go/v2/api/datadog" "github.com/DataDog/datadog-api-client-go/v2/api/datadogV2" ) func main() { ctx := datadog.NewDefaultContext(context.Background()) ctx = context.WithValue(ctx, datadog.ContextAccessToken, os.Getenv("DD_BEARER_TOKEN")) configuration := datadog.NewConfiguration() apiClient := datadog.NewAPIClient(configuration) api := datadogV2.NewDataDeletionApi(apiClient) resp, r, err := api.GetDataDeletionRequests(ctx, *datadogV2.NewGetDataDeletionRequestsOptionalParameters()) if err != nil { fmt.Fprintf(os.Stderr, "Error when calling `DataDeletionApi.GetDataDeletionRequests`: %v\n", err) fmt.Fprintf(os.Stderr, "Full HTTP response: %v\n", r) } responseContent, _ := json.MarshalIndent(resp, "", " ") fmt.Fprintf(os.Stdout, "Response from `DataDeletionApi.GetDataDeletionRequests`:\n%s\n", responseContent) } ``` #### Instructions First [install the library and its dependencies](https://docs.datadoghq.com/api/latest.md?code-lang=go) and then save the example to `main.go` and run following commands: DD_SITE="datadoghq.com" DD_BEARER_TOKEN="" go run "main.go" ##### ```java // Gets a list of data deletion requests returns "OK" response import com.datadog.api.client.ApiClient; import com.datadog.api.client.ApiException; import com.datadog.api.client.v2.api.DataDeletionApi; import com.datadog.api.client.v2.model.GetDataDeletionsResponseBody; public class Example { public static void main(String[] args) { ApiClient defaultClient = ApiClient.getDefaultApiClient(); defaultClient.setAccessToken(System.getenv("DD_BEARER_TOKEN")); DataDeletionApi apiInstance = new DataDeletionApi(defaultClient); try { GetDataDeletionsResponseBody result = apiInstance.getDataDeletionRequests(); System.out.println(result); } catch (ApiException e) { System.err.println("Exception when calling DataDeletionApi#getDataDeletionRequests"); System.err.println("Status code: " + e.getCode()); System.err.println("Reason: " + e.getResponseBody()); System.err.println("Response headers: " + e.getResponseHeaders()); e.printStackTrace(); } } } ``` #### Instructions First [install the library and its dependencies](https://docs.datadoghq.com/api/latest.md?code-lang=java) and then save the example to `Example.java` and run following commands: DD_SITE="datadoghq.com" DD_BEARER_TOKEN="" java "Example.java" ##### ```rust // Gets a list of data deletion requests returns "OK" response use datadog_api_client::datadog; use datadog_api_client::datadogV2::api_data_deletion::DataDeletionAPI; use datadog_api_client::datadogV2::api_data_deletion::GetDataDeletionRequestsOptionalParams; #[tokio::main] async fn main() { let configuration = datadog::Configuration::new(); let api = DataDeletionAPI::with_config(configuration); let resp = api .get_data_deletion_requests(GetDataDeletionRequestsOptionalParams::default()) .await; if let Ok(value) = resp { println!("{:#?}", value); } else { println!("{:#?}", resp.unwrap_err()); } } ``` #### Instructions First [install the library and its dependencies](https://docs.datadoghq.com/api/latest.md?code-lang=rust) and then save the example to `src/main.rs` and run following commands: DD_SITE="datadoghq.com" DD_API_KEY="" DD_APP_KEY="" cargo run ##### ```typescript /** * Gets a list of data deletion requests returns "OK" response */ import { client, v2 } from "@datadog/datadog-api-client"; const configuration = client.createConfiguration({ authMethods: { AuthZ: { accessToken: process.env.DD_BEARER_TOKEN as string, }, }, }); const apiInstance = new v2.DataDeletionApi(configuration); apiInstance .getDataDeletionRequests() .then((data: v2.GetDataDeletionsResponseBody) => { console.log( "API called successfully. Returned data: " + JSON.stringify(data) ); }) .catch((error: any) => console.error(error)); ``` #### Instructions First [install the library and its dependencies](https://docs.datadoghq.com/api/latest.md?code-lang=typescript) and then save the example to `example.ts` and run following commands: DD_SITE="datadoghq.com" DD_BEARER_TOKEN="" tsc "example.ts" {% /tab %}