Place compliance hold on account funds

POST

/v1/admin/accounts/{id}/holds

Place compliance hold on account funds. Handled by finance-service. See request body schema and response model for field-level validation.

Authentication: Bearer JWT with admin role. Required permission: accounts:hold.

Request

Authorization

JWT Bearer

Add the parameter

Authorization

to Headers

Example:

Authorization: ********************

Path Params

Body Params application/json

Examples

Responses

🟢201

application/json

Compliance hold placed

Bodyapplication/json

🟠400BadRequest

🟠401Unauthorized

🟠403Forbidden

🟠404NotFound

🟠409Conflict

🔴500InternalError

Request Example

Shell

JavaScript

Java

Swift

curl --location '/v1/admin/accounts//holds' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "property1": "string",
    "property2": "string"
}'

Response Example

201 - Example 1

{
    "hold_id": "4ce991bb-2101-434c-985c-39697d3f31c4"
}

Modified at 2026-06-25 03:02:50

Execute pending transfer

Reject pending transfer