--- schema_version: "1" id: 12809e6af8d7fede31d97170ec8940ed418cfac191ca917caea35f2dffb5e599 title: GET /contacts/v1/contacts/analytics/deleterequests collection: developer version: current locale: en-us portal_url: https://docs.salesforce.com/developer/current/en-us/marketing-cloud/guides/mc-apis/ContactsDeleteRequestsDetails.md canonical_url: https://developer.salesforce.com/docs/marketing/marketing-cloud/references/mc_rest_contacts/ContactsDeleteRequestsDetails.html source_site: developer.salesforce.com content_type: documentation content_hash: 0246b6503a2ece1edfada11710392df2c62b6a7e2b2fe224b4b5822f1d5a0f7e products: - Marketing Cloud Engagement APIs and Programmatic Languages - Marketing Cloud --- # GET /contacts/v1/contacts/analytics/deleterequests Retrieves details of contact delete requests for a date range. ## URL Parameters | Name | Type | | Description | | ---------------- | -------- | ------------ | -------------------------------------------------------------------------------------------------------------------------------------- | | **startdateutc** | datetime | **Required** | Start date and time in UTC of the date range. | | **enddateutc** | datetime | **Required** | End date and time in UTC of the date range. | | **statusid** | int | | Delete request status ID. Use it to filter delete requests by status. Valid values are 1 - Processing, 5 - Completed, and 7 - Invalid. | | **$pagesize** | int | | Number of records per page. | | **$page** | int | | Page number to retrieve. | | **$orderBy** | string | | Determines which property to use for sorting and the direction in which to sort the data. | ## Responses | Status | Name | Type | Description | | ------- | --------------------------------- | -------- | -------------------------------------------------------------------------------------------------------------- | | **200** |   |   | **Retrieved contact delete requests details.** | |   | startDateUtc | datetime | Start date and time in UTC of the date range. | |   | endDateUtc | datetime | End date and time in UTC of the date range. | |   | pageSize | integer | Page size of results retrieved. | |   | pageNumber | integer | Page number of results retrieved. | |   | operations | array | Contact delete request information. | |   | operations\:operationid | int | Contact delete request ID. | |   | operations\:receiveddateutc | datetime | Date and time in UTC when the contact delete request was created. | |   | operations\:status | string | Status of the contact delete request. | |   | operations\:totalcontactcount | int | Total number of contacts in the contact delete request. | |   | operations\:completedcontactcount | int | Number of contacts that were deleted in the delete request. | |   | operations\:laststatusdateutc | datetime | Date and time in UTC when the delete request’s status was most recently modified. | |   | operations\:deletemethod | string | Method used to delete the contacts. | |   | statusasofdateutc | datetime | Date and time in UTC when the status was retrieved. | |   | requestServiceMessageID | guid | Service message ID for the request. | |   | responseDateTime | datetime | Date and time in UTC when the response was created in the system. | |   | resultMessages | array | Array of messages about the request. Includes details, such as resulttype and resultcode, about a bad request. | |   | serviceMessageID | guid | Service message ID for the response. | |   |   |   |   | | **400** |   |   | **The request is missing a required parameter or contains an invalid parameter.** | |   | startDateUtc | datetime | Start date and time in UTC of the date range. | |   | endDateUtc | datetime | End date and time in UTC of the date range. | |   | pageSize | integer | Page size of results retrieved. | |   | pageNumber | integer | Page number of results retrieved. | |   | statusasofdateutc | datetime | Date and time in UTC when the status of the contact delete request was retrieved. | |   | requestServiceMessageID | guid | Service message ID for the request. | |   | responseDateTime | datetime | Date and time in UTC when the response was created in the system. | |   | resultMessages | array | Array of messages about the request. Includes details, such as resulttype and resultcode, about a bad request. | |   | serviceMessageID | guid | Service message ID for the response. | ### Usage **Example Request** ```js Host: https://YOUR_SUBDOMAIN.rest.marketingcloudapis.com GET contacts/v1/contacts/analytics/deleterequests?startdateutc=2019-02-18T00%3A00%3A00&enddateutc=2019-03-19T00%3A00%3A00&%24page=1&%24pagesize=20&%24orderby=operationId%20desc&statusid=5 Content-Type: application/json Authorization: Bearer YOUR_ACCESS_TOKEN ``` **Example Response** ```js { "startDateUtc":"2019-02-18T00:00:00", "endDateUtc":"2019-03-19T00:00:00", "statusAsOfDateUtc":"2019-03-19T19:33:17.496471Z", "pageNumber":1, "pageSize":20, "operations":[ { "operationId":22944, "totalContactCount":1, "completedContactCount":1, "receivedDateUtc":"2019-03-04T22:42:00", "status":"Completed", "lastStatusDateUtc":"2019-03-19T04:47:40.293", "deleteMethod":"Contact Key/ID" }, { "operationId":22943, "totalContactCount":1, "completedContactCount":1, "receivedDateUtc":"2019-03-04T22:41:00", "status":"Completed", "lastStatusDateUtc":"2019-03-19T04:47:40.293", "deleteMethod":"Contact Key/ID" }, { "operationId":22625, "totalContactCount":1, "completedContactCount":1, "receivedDateUtc":"2019-02-26T23:26:00", "status":"Completed", "lastStatusDateUtc":"2019-03-13T10:10:17.9", "deleteMethod":"Contact Key/ID" }, { "operationId":22624, "totalContactCount":1, "completedContactCount":1, "receivedDateUtc":"2019-02-26T23:25:00", "status":"Completed", "lastStatusDateUtc":"2019-03-13T10:10:17.9", "deleteMethod":"Contact Key/ID" }, { "operationId":22598, "totalContactCount":1, "completedContactCount":1, "receivedDateUtc":"2019-02-26T16:22:00", "status":"Completed", "lastStatusDateUtc":"2019-03-13T00:41:55.317", "deleteMethod":"Contact Key/ID" }, { "operationId":22597, "totalContactCount":1, "completedContactCount":1, "receivedDateUtc":"2019-02-26T16:21:00", "status":"Completed", "lastStatusDateUtc":"2019-03-13T00:41:55.317", "deleteMethod":"Contact Key/ID" }, { "operationId":22594, "totalContactCount":1, "completedContactCount":1, "receivedDateUtc":"2019-02-26T04:34:00", "status":"Completed", "lastStatusDateUtc":"2019-03-12T13:36:48.677", "deleteMethod":"Contact Key/ID" }, { "operationId":22593, "totalContactCount":1, "completedContactCount":1, "receivedDateUtc":"2019-02-26T04:33:00", "status":"Completed", "lastStatusDateUtc":"2019-03-12T13:36:48.677", "deleteMethod":"Contact Key/ID" }, { "operationId":22544, "totalContactCount":1, "completedContactCount":1, "receivedDateUtc":"2019-02-25T17:03:00", "status":"Completed", "lastStatusDateUtc":"2019-03-11T23:06:49.167", "deleteMethod":"Contact Key/ID" }, { "operationId":22543, "totalContactCount":1, "completedContactCount":1, "receivedDateUtc":"2019-02-25T17:02:00", "status":"Completed", "lastStatusDateUtc":"2019-03-11T23:06:49.167", "deleteMethod":"Contact Key/ID" }, { "operationId":22535, "totalContactCount":1, "completedContactCount":1, "receivedDateUtc":"2019-02-25T16:00:00", "status":"Completed", "lastStatusDateUtc":"2019-03-11T22:06:33.593", "deleteMethod":"Contact Key/ID" }, { "operationId":22534, "totalContactCount":1, "completedContactCount":1, "receivedDateUtc":"2019-02-25T15:59:00", "status":"Completed", "lastStatusDateUtc":"2019-03-11T22:06:33.593", "deleteMethod":"Contact Key/ID" }, { "operationId":22409, "totalContactCount":1, "completedContactCount":1, "receivedDateUtc":"2019-02-22T20:05:00", "status":"Completed", "lastStatusDateUtc":"2019-03-09T08:49:36.62", "deleteMethod":"Contact Key/ID" }, { "operationId":22408, "totalContactCount":1, "completedContactCount":1, "receivedDateUtc":"2019-02-22T20:04:00", "status":"Completed", "lastStatusDateUtc":"2019-03-09T08:49:36.62", "deleteMethod":"Contact Key/ID" }, { "operationId":22313, "totalContactCount":1, "completedContactCount":1, "receivedDateUtc":"2019-02-21T05:02:00", "status":"Completed", "lastStatusDateUtc":"2019-03-07T11:04:41.687", "deleteMethod":"Contact Key/ID" }, { "operationId":22312, "totalContactCount":1, "completedContactCount":1, "receivedDateUtc":"2019-02-21T05:01:00", "status":"Completed", "lastStatusDateUtc":"2019-03-07T11:04:41.687", "deleteMethod":"Contact Key/ID" } ], "requestServiceMessageID":"e1198208-6432-40fd-b5ae-172c9d9bc44a", "responseDateTime":"2019-03-19T13:33:18.2141124-06:00", "resultMessages":[ ], "serviceMessageID":"ef7d833c-509f-4dbc-8f99-060aac3c0382" } ```