Skip to main content
DELETE
/
v1
/
customers
/
{id}
Delete Customer
curl --request DELETE \
  --url https://api.example.com/v1/customers/{id} \
  --header 'Authorization: <authorization>'

Delete Customer

Permanently delete a customer from your organization.

Endpoint

DELETE /v1/customers/{id}

Authentication

Authorization
string
required
Bearer token with customers:write scope

Path Parameters

id
string
required
The customer ID (e.g., cust_abc123)

Request Example

curl -X DELETE "https://api.tiquo.co/v1/customers/cust_abc123" \
  -H "Authorization: Bearer sk_live_xxxxx"

Response

Returns confirmation of deletion.

Response Example

{
  "success": true,
  "data": {
    "id": "cust_abc123",
    "deleted": true
  }
}

What Gets Deleted

When you delete a customer:
DataAction
Customer profilePermanently deleted
Loyalty pointsLost
TagsRemoved
NotesDeleted
Future bookingsCancelled
Past ordersRetained (anonymized)
DocumentsDeleted
Customer deletion is permanent and cannot be undone.

Data Retention

For compliance and record-keeping:
  • Past orders are retained but anonymized
  • Transaction history keeps amounts, not customer details
  • Analytics data is aggregated (no personal info)

Errors

CodeDescription
401Invalid API key
403Missing customers:write scope
404Customer not found
409Customer has active orders

404 Example

{
  "success": false,
  "error": {
    "code": "not_found",
    "message": "Customer not found"
  }
}

409 Conflict Example

{
  "success": false,
  "error": {
    "code": "conflict",
    "message": "Cannot delete customer with active bookings",
    "activeBookings": 2
  }
}
Cancel or complete active bookings before deleting the customer.

Alternative: Archive

Instead of deleting, consider archiving:
PATCH /v1/customers/{id}
{
  "archived": true
}
Archived customers:
  • Don’t appear in lists
  • Can be restored
  • Keep history
  • Preserve data

GDPR Compliance

For GDPR right-to-erasure requests:
  1. Use DELETE endpoint
  2. All personal data is removed
  3. Anonymized records retained for legal requirements
  4. Confirmation provided

Code Examples

const customerId = 'cust_abc123';

const response = await fetch(`https://api.tiquo.co/v1/customers/${customerId}`, {
  method: 'DELETE',
  headers: {
    'Authorization': `Bearer ${apiKey}`
  }
});

const result = await response.json();
if (result.success) {
  console.log('Customer deleted');
}