Request that a merchant block be cleared, with the reason (cards:write, fresh step-up); the block stands until a second staff member approves

POST/merchant-blocks/{id}/clear

Path parameters

idstringRequired

Headers

Idempotency-KeystringOptional

Send on every write that creates or changes money or state; a replay with the same key returns the original result with 200.

Body parameters

notestringRequired

Returns

201 Created

The Merchant Block object.

Errors

Every error is a problem document with a stable code. See Errors.

400401403404409412413422424429500503

Request

curl -X POST 'https://api.dev.bank.corgi.com/merchant-blocks/{id}/clear' \
  -H "Authorization: Bearer $TOKEN" \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "note": "string"
  }'

Response201

{
  "alert_id": "alrt_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
  "authorization_id": "auth_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
  "clear_note": "string",
  "clearance": {
    "decided_at": "2026-09-17T14:30:00Z",
    "decided_by": "string",
    "decision": "string",
    "decision_note": "string",
    "id": 0,
    "note": "string",
    "requested_at": "2026-09-17T14:30:00Z",
    "requested_by": "string"
  },
  "cleared_at": "2026-09-17T14:30:00Z",
  "cleared_by": "string",
  "country": "string",
  "created_at": "2026-09-17T14:30:00Z",
  "id": "string",
  "merchant_id": "string",
  "merchant_name": "string",
  "name_key": "string",
  "result": "string",
  "screening_id": "scrn_2tVh8nqLxq4GbDe0K1F6S9zRcWm",
  "status": "string"
}