Customers

Delete customer

Delete a customer.

DELETE/v1/customers/{customer_id}

Operation delete_customer · Scope customers:write · Spec snapshot 2026-09-13

Parameters

Parameter	Description
customer_idstring · pathrequired	No description in the spec.

Returns a DeletedResource object.

Status	Cause
401	Missing or invalid API key.
403	Key is missing the `customers:write` scope.
404	No such object, or it belongs to the other mode.
422	Validation Error
429	Rate limited. Back off and retry.

Request · curl

curl -X DELETE https://api.billkit.eu/v1/customers/cus_9XKp2vQ1 \
  -H "Authorization: Bearer $BILLKIT_SECRET_KEY"

curl -X DELETE https://api.billkit.eu/v1/customers/cus_9XKp2vQ1 \
  -H "Authorization: Bearer $BILLKIT_SECRET_KEY"

Response · 200 OK

{
  "deleted": true,
  "id": "obj_9XKp2vQ1",
  "object": "string"
}

{
  "deleted": true,
  "id": "obj_9XKp2vQ1",
  "object": "string"
}