REST
DELETE
/api/v1/end-users/relationsDelete End User Relation
Deletes the relation with an end user (individual or business).
Auth:Bearer <api_key>
Tags:BankingSandbox
This endpoint is only available in the Sandbox environment. It will not work in production.
Request
cURL
curl -X DELETE https://publicapi.sandbox.hercle.financial/api/v1/end-users/relations \
-H "Authorization: Bearer eyJhb..." \
-H "Content-Type: application/json" \
-d '{"id": "addr_1234567890"}'Headers
| Name | Type | Required | Description |
|---|---|---|---|
| Authorization | string | Yes | Bearer API_KEY Example: Bearer your_api_key_here |
| Content-Type | string | Yes | application/json Example: application/json |
Request Body
Schema
| Field | Type | Description | Required |
|---|---|---|---|
endUserId | string | Unique identifier of the end user | Yes |
endUserType | string | Type of end user Allowed values: IndividualBusiness | Yes |
Example
{
"endUserId": "eu_abc123",
"endUserType": "Individual"
}Response
Success Response Schema
End user relation successfully deleted
| Field | Type | Description |
|---|---|---|
endUserId | string | Unique identifier of the deleted end user |
endUserType | string | Type of end user (individual or business) |
deletedAt | string | ISO 8601 timestamp of when the relation was deleted |
Delete End User Relation Response Object
Response containing the deleted end user relation details
| Field | Type | Description |
|---|---|---|
endUserId | string | Unique identifier of the deleted end user |
endUserType | string | Type of end user (individual or business) |
deletedAt | string | ISO 8601 timestamp of when the relation was deleted |
Responses
End user relation successfully deleted
200 application/json
{
"endUserId": "eu_abc123",
"endUserType": "individual",
"deletedAt": "2026-04-02T12:00:00Z"
}API Tester
Test this endpoint directly against the sandbox environment
Get your API key from Hercle Sandbox
https://publicapi.sandbox.hercle.financial/api/v1/end-users/relations