Skip to main content
DELETE
Delete a customer

Authorizations

Authorization
string
header
required

API key authentication. Include your API key in the Authorization header as Bearer <api_key>.

Headers

Idempotency-Key
string

Unique key for idempotent requests (24-hour cache)

Path Parameters

customerId
string
required

Customer ID (e.g., cus_...)

Response

Customer deleted

id
string
required

Unique customer ID

type
enum<string>
required

Customer type

Available options:
consumer,
corporate
status
enum<string>
required

Customer status

Available options:
pending,
active,
deleted
email
string | null

Customer email

phone
string | null

Customer phone number

name
object
policy
object

Spending policy controls

metadata
object

Custom metadata

createdAt
string<date-time> | null