---
schema_version: "1"
id: c7357a264faf1050ef2d0328e661627c6a43a66d93240298b2dc816a81f8318e
title: POST /contacts/v1/contacts/actions/restrict?type=ids
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/marketing-cloud/guides/mc-apis/restrict-contact-id.md
canonical_url: https://developer.salesforce.com/docs/marketing/marketing-cloud/references/mc_rest_contacts/restrict-contact-id.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: a59ce5363ed1d9ef3125e6203f810804fda44bc96d05fdf428d2605c87eab94c
products:
  - Marketing Cloud Engagement APIs and Programmatic Languages
  - Marketing Cloud
---
# POST /contacts/v1/contacts/actions/restrict?type=ids

## Overview

Restricts processing for contacts identified by ContactID values in the request. This operation runs asynchronously. Use the OperationID value returned to check the status of the delete.

| Name   | Type  |          | Description                       |
| ------ | ----- | -------- | --------------------------------- |
| Values | array | Required | Array of contact IDs to restrict. |

## Responses

| Status  | Name                    | Type    | Description                                                                                                                                                             |
| ------- | ----------------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **200** |                    |    | **Restrict request response**                                                                                                                                           |
|    | operationInitiated      | boolean | System-initiated restrict operation.                                                                                                                                    |
|    | operationID             | integer | Auto-generated restrict operation ID. Keep track of this ID because it allows you to check the status of a restriction and decide how to proceed if there is a failure. |
|    | requestServiceMessageID | guid    | Service message ID for the request.                                                                                                                                     |
|    | responseDateTime        | integer | The datetime restrict response is created in the system in GMT time.                                                                                                    |
|    | hasErrors               | boolean | The requested operation is initiated with an error or not.                                                                                                              |
|    | resultMessages          | array   | Array of messages about the restrict operation.                                                                                                                         |
|    | serviceMessageID        | guid    | Service message ID for the response.                                                                                                                                    |
|    |                    |    |                                                                                                                                                                    |
| **400** |                    |    | **Bad restrict request response**                                                                                                                                       |
|    | operationInitiated      | boolean | System-initiated restrict operation.                                                                                                                                    |
|    | operationID             | integer | Auto-generated restrict operation ID. Keep track of this ID because it allows you to check the status of a restriction and decide how to proceed if there is a failure. |
|    | requestServiceMessageID | guid    | Service message ID for the request.                                                                                                                                     |
|    | responseDateTime        | integer | The datetime restrict response is created in the system in GMT time.                                                                                                    |
|    | hasErrors               | boolean | The requested operation is initiated with error or not. For a 400 response this is true.                                                                                |
|    | resultMessages          | array   | Array of messages about the restrict operation, with details about the bad request, like resulttype and resultcode.                                                     |
|    | serviceMessageID        | guid    | Service message ID for the response.                                                                                                                                    |