---
title: "Withdraw a funded settlement request"
method: POST
path: "/api-regulated/v1/guards/{guardId}/guard-settlements/{settlementId}/cancel-funding-request"
tags: ["GuardSettlement"]
---

# Withdraw a funded settlement request

`POST /api-regulated/v1/guards/{guardId}/guard-settlements/{settlementId}/cancel-funding-request`

## Request

- Base URL: `https://api.currencyguard.com`
- URL: `https://api.currencyguard.com/api-regulated/v1/guards/{guardId}/guard-settlements/{settlementId}/cancel-funding-request`
- Auth: OAuth 2 (implicit, authorization URL `https://auth.currencyguard.com/oauth2/authorize`, scopes: `regulated.risk-management.canSettleGuard`)

Withdraws a request that has not been funded, freeing the slice of the Guard it claimed. The row is kept and moves to FUNDING_CANCELLED -- the slice is released by dropping out of the claimed total, not by writing an amount back. Refused once the money has arrived: from then on CurrencyGuard is holding client funds and is committed to executing.

**Required entitlement:** `regulated.risk-management.canSettleGuard`  
_Entitles the regulated user to settle existing guard positions for their customers_

## Path parameters

- `guardId` string, required
- `settlementId` string, required

## Request body

- RegulatedCancelFundingRequest
  - `reason` string

## Response `200`

Funding request withdrawn

## Other responses

- `401`: Not authenticated — [`security/authentication-failed`](/problems/security/authentication-failed/)
- `403`: Not authorized — [`security/insufficient-permissions`](/problems/security/insufficient-permissions/)
- `404`: Guard settlement not found — [`http/resource-not-found`](/problems/http/resource-not-found/)
- `422`: No longer awaiting funding **Problem types returned by this endpoint** | Type | Meaning | |---|---| | [`guard-settlement/funding-request-not-cancellable`](/problems/guard-settlement/funding-request-not-cancellable/) | Withdrawal was attempted on a funded settlement that is no longer awaiting the client's money |
- `500`: Server error — [`server/internal-error`](/problems/server/internal-error/)

---

[API](https://skmtc.dev/currencyguard/apis/currencyguard-trading-system-api-external.md) · [All operations](https://skmtc.dev/currencyguard/apis/currencyguard-trading-system-api-external/llms.txt) · [OpenAPI document](https://skmtc.dev/currencyguard/apis/currencyguard-trading-system-api-external/revisions/a1f3f854190d?raw)