Skip to main content

Delete Customer

Delete a customer record.

Endpointโ€‹

DELETE /v1/customers/{id}

Authenticationโ€‹

Requires an API key with the customers:write scope.

Parametersโ€‹

ParameterTypeLocationDescription
idintegerpathThe customer ID

Example Requestโ€‹

curl -X DELETE "https://app.equipdash.com/api/v1/customers/256" \
-H "Authorization: Bearer eqd_live_abc123xyz789..."

Responseโ€‹

Success (200 OK)โ€‹

{
"data": {
"deleted": true
},
"meta": {
"request_id": "req_abc123",
"timestamp": "2026-01-15T12:00:00+00:00"
}
}

Errorsโ€‹

StatusCodeDescription
401authentication_requiredNo API key provided
401invalid_api_keyInvalid API key
403insufficient_scopeAPI key lacks customers:write scope
403forbiddenCustomer belongs to different supplier
404resource_not_foundCustomer does not exist

Notesโ€‹

  • Deleting a customer does not delete their historical bookings
  • Deleted customer data is retained for audit purposes
  • Consider updating the customer record instead of deleting if you need to preserve data