---
title: "Reject a transfer"
method: POST
path: "/entities/{entityDID}/tx/{transferId}/reject"
tags: ["Transfers"]
---

# Reject a transfer

`POST /entities/{entityDID}/tx/{transferId}/reject`

Rejects a transfer with a specified reason. If the reason is OTHER, a comment is required.

## Path parameters

- `entityDID` string, did, required — Decentralized Identifier (DID)
- `transferId` string, uuid, required

## Request body

- object
  - `reason` 'COUNTERPARTY_RISK' | 'COUNTERPARTY_DUE_DILIGENCE' | 'BLOCKCHAIN_RISK_SCORE' | 'SANCTION_SCREENING' | 'ASSET_TYPE' | 'SUSPICIOUS_TRANSACTION' | 'COUNTERPARTY_POLICIES' | 'COUNTERPARTY_REJECTED' | 'COUNTERPARTY_NO_RESPONSE' | 'CANCELED_BY_INITIATOR' | 'REMOVED_FROM_TRANSFER' | 'TRANSFER_PARTICIPANT' | 'SOURCE_ADDRESS' | 'BENEFICIARY_ADDRESS' | 'BENEFICIARY_NOT_FOUND' | 'ORIGINATOR_REJECT_OUTGOING' | 'BENEFICIARY_REJECT_INCOMING' | 'COMPLIANCE_POLICIES' | 'OTHER', required — The reason for rejecting the transfer
  - `comment` string — Additional comment (required when reason is OTHER)

## Response `200`

Transfer rejected successfully

- object
  - `message` string

## Other responses

- `400` — Bad Request - The server could not process the request due to a client error.
- `401` — Unauthorized - Authentication information is missing or invalid.
- `403` — Forbidden - The server understood the request but refuses to authorize it.
- `404` — Not Found - The requested resource could not be found.
- `409` — Conflict - The request could not be completed due to a conflict with the current state of the resource.
- `500` — Internal Server Error - An unexpected condition was encountered on the server.

---

[API](https://skmtc.net/notabene/apis/notabene-api.md) · [All operations](https://skmtc.net/notabene/apis/notabene-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/notabene/notabene-api/versions/70056745a433/schema)