Delete a customer

Delete a customer by their public identifier in Raims.

DELhttps://api.raims.com/v1/customers/{id}

Deletes a customer by public identifier when you no longer need the record. The customer must belong to the company and environment of your API key.

Deletion is allowed only when the customer has no linked charges that have not been deleted, including paid charges. If any such charge exists, the customer is kept. This request does not delete charges or refund payments.

Repeating the request for a customer already deleted from the same company and environment returns the same confirmation. See how deletion affects lookups in Delete a customer.

Path Params

idstringrequired

The customer's public ID in Raims, returned when the customer is created or listed.

Up to 100 characters

Responses

For common errors, see HTTP response codes.

Updated 13 hours ago

Language

Credentials

Header

cURL Request

curl --request DELETE \
  --url https://api.raims.com/v1/customers/%7Bid%7D \
  --header 'accept: application/json'

Response

Click Try it to send a request and see the response here. Or choose an example:

application/json

Delete a customer

Path Params

Responses

200OK

400Bad Request

404Not Found

409Conflict