# Delete contact

Delete a contact.

# Method

DELETE

# Path

/contacts/[phone_number]

# Path parameter

Name	Value	Required?
phone_number	Phone number starting with the country code with or without leading plus. e.g. `+16175551212` or `16175551212`	Yes

# Body parameters

Name	Value	Data type	Required?
list_id	0 - to delete the contact (including from all the contact lists) or List ID - to delete only from a contact list (List ID is the value shown in the address bar when a list is selected on the Contacts page)	Integer	No (defaults to 0)

# Response

# HTTP status codes

Code	Remarks
200	Request was successful.
400	Validation error or request body was incorrectly formatted.
401	Authentication failed. Check `apikey` header.
404	Requested API endpoint not found.
429	The rate limit has been reached.
500-511	There was a problem processing the request on our server. Try again later.

# Response object

Name	Value	Remarks
status	`success` or `error`	-
errors	Array of object `{ msg: [error detail] }`	Only present when status is `error`

# Code sample

curl --location --request DELETE 'https://api.sociocs.com/contact/16175551212' \
--header 'apikey: [your api key]'
--header 'Content-Type: application/json' \
--data-raw '{
    "list_id_": 0
}'