Skip to main content
DELETE
/
v1
/
customers
/
{customer_id}
Delete a customer
curl --request DELETE \
  --url https://api.dev.bsa.ai/v1/customers/{customer_id} \
  --header 'Authorization: Bearer <token>'
Deletion is only permitted while a customer is in pending state. Because customers created via this API are activated immediately, partner-created customers are effectively never deletable — use Close instead.
Two equivalent forms — see Addressing a customer.

​
Path parameters

​
customer_id
string
required
LMS id, or the externalId on the /external/{customer_external_id} form.

​
Examples

# By LMS id
curl -sf -X DELETE "$BASE/v1/customers/42" \
  -H "Authorization: Bearer $TOKEN"

# By externalId
curl -sf -X DELETE "$BASE/v1/customers/external/ext-ada-001" \
  -H "Authorization: Bearer $TOKEN"

​
Response

200 OK with an empty body.

​
Errors

CodeWhen
not_foundNo customer with that ID
abortedCustomer is not in pending state, or has associated loans