Skip to main content
DELETE
/
api
/
customers
/
{id}
Delete Customer
curl --request DELETE \
  --url https://app-api.my-virtual-office.com/api/customers/{id} \
  --header 'X-API-Key: <x-api-key>'
{
  "error": "Unauthorized",
  "message": "API key is required. Provide it via X-API-Key header or Authorization Bearer token."
}

Delete Customer

Permanently delete a customer from your seller account. This action cannot be undone.

Authentication

X-API-Key
string
required
Your API key. Can also be provided via Authorization: Bearer header.

Path Parameters

id
string
required
The UUID of the customer to delete.

Response

Returns 204 No Content on success with an empty body.

Example Request

curl -X DELETE https://app-api.my-virtual-office.com/api/customers/550e8400-e29b-41d4-a716-446655440000 \
  -H "X-API-Key: sk_live_your_api_key_here"

Error Responses

{
  "error": "Unauthorized",
  "message": "API key is required. Provide it via X-API-Key header or Authorization Bearer token."
}
{
  "error": "Not Found",
  "message": "Customer not found"
}

Error Codes

HTTP CodeErrorDescription
401UnauthorizedMissing or invalid API key
404Not FoundCustomer not found or does not belong to your account
500Internal Server ErrorUnexpected server error