> ## Documentation Index > Fetch the complete documentation index at: https://docs.hifi.com/llms.txt > Use this file to discover all available pages before exploring further. # Reject a transfer > Reject a pending transfer approval. Requires an admin organization role. Returns a conflict error if the approval has already been resolved. ## OpenAPI ````yaml https://production.hifi.com/api/v3/openapi.json post /v3/transfer-approvals/{transferApprovalId}/reject openapi: 3.0.0 info: title: Hifi API version: 3.0.0 description: API documentation for HIFI servers: - url: https://production.hifi.com description: Production server - url: https://sandbox.hifi.com description: Sandbox server security: - bearerAuth: [] tags: - name: Common description: Common endpoints - name: User description: User endpoints - name: Counter Party description: Counter party endpoints - name: Crypto Transfer description: Crypto transfer and batch transfer endpoints - name: Wallet description: Wallet and wallet offer endpoints - name: External Account description: External bank account endpoints (under a counter party) - name: External Wallet description: External wallet endpoints (under a counter party) - name: External Card description: External card endpoints (under a counter party) - name: Token Swap description: Token swap endpoints - name: Bridge description: Bridge endpoints - name: Virtual Account description: Virtual account endpoints - name: Compliance description: Compliance and compliance link endpoints - name: Webhook Endpoint description: Webhook endpoint endpoints - name: File description: File upload endpoints - name: Onramp description: Onramp (fiat to crypto) endpoints - name: Offramp description: Offramp (crypto to fiat) endpoints - name: Orchestration Address description: Orchestration (liquidation) address endpoints - name: KYC Link description: Hosted and custom KYC/KYB link endpoints - name: Transfer Approval description: Transfer approval endpoints - name: Corridor description: Supported fiat/crypto transfer corridor endpoints - name: Migration description: v2-to-v3 ID mapping endpoints paths: /v3/transfer-approvals/{transferApprovalId}/reject: post: tags: - Transfer Approval summary: Reject a transfer description: | Reject a pending transfer approval. Requires an admin organization role. Returns a conflict error if the approval has already been resolved. operationId: v3RejectTransfer parameters: - $ref: '#/components/parameters/TransferApprovalIdPathParameter' requestBody: $ref: '#/components/requestBodies/TransferApprovalRejectBody' responses: '200': $ref: '#/components/responses/RejectTransferApprovalResponse' '401': $ref: '#/components/responses/UnauthorizedResponse' '404': $ref: '#/components/responses/NotFoundResponse' '409': $ref: '#/components/responses/ConflictResponse' '422': $ref: '#/components/responses/ResourceNotEligibleResponse' '500': $ref: '#/components/responses/InternalServerErrorResponse' components: parameters: TransferApprovalIdPathParameter: name: transferApprovalId in: path required: true schema: type: string description: Public ID of the transfer approval (prefixed with `ta_`) example: ta_9aB0xY4mNpXwZ7bV1aLdt requestBodies: TransferApprovalRejectBody: required: false description: Optional comment to attach to the rejection. content: application/json: schema: $ref: '#/components/schemas/TransferApprovalActionBody' example: comment: Amount exceeds approved limit. responses: RejectTransferApprovalResponse: description: Transfer rejected successfully. content: application/json: schema: $ref: '#/components/schemas/TransferApprovalObject' example: id: ta_9aB0xY4mNpXwZ7bV1aLdt status: REJECTED transferId: e1a2b3c4-5678-90ab-cdef-1234567890ab transferType: OFFRAMP fromDashboard: false initiatorProfileId: 9f1e2d3c-4b5a-6978-8071-6253849abcde votes: - approverId: 1a2b3c4d-5e6f-7089-a1b2-c3d4e5f60789 vote: REJECT comment: Amount exceeds approved limit. createdAt: '2026-07-01T10:35:00.000Z' createdAt: '2026-07-01T10:30:00.000Z' updatedAt: '2026-07-01T10:35:00.000Z' UnauthorizedResponse: description: Unauthorized content: application/json: schema: $ref: '#/components/schemas/Unauthorized' NotFoundResponse: description: Not Found content: application/json: schema: $ref: '#/components/schemas/NotFound' ConflictResponse: description: >- Conflict — the request collides with the current state of the resource (e.g. idempotency-key reuse with a different payload). content: application/json: schema: $ref: '#/components/schemas/ApiError' example: type: RESOURCE_CONFLICT message: Resource already exists or conflicts with current state ResourceNotEligibleResponse: description: >- Unprocessable Entity — the resource exists but is not eligible for the requested operation in its current state. content: application/json: schema: $ref: '#/components/schemas/ApiError' example: type: ACTION_NOT_ALLOWED message: This action is not allowed InternalServerErrorResponse: description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/InternalServerError' schemas: TransferApprovalActionBody: type: object description: Optional comment to attach to the approval decision. properties: comment: type: string example: Confirmed with finance. TransferApprovalObject: type: object description: A pending or resolved transfer approval. properties: id: type: string description: Public ID of the transfer approval (prefixed with `ta_`). example: ta_9aB0xY4mNpXwZ7bV1aLdt status: type: string enum: - PENDING - APPROVED - REJECTED - EXPIRED example: PENDING transferId: type: string description: >- Internal identifier of the transfer awaiting approval. Note: this is not currently the transfer's public ID (e.g. its `ofrmp_`/`brdg_`/`ctr_` ID) and cannot be used to look it up via the API. example: e1a2b3c4-5678-90ab-cdef-1234567890ab transferType: type: string enum: - CRYPTO_TRANSFER - OFFRAMP - BRIDGE - ONRAMP - BATCH_CRYPTO_TRANSFER description: The resource type `transferId` belongs to. example: OFFRAMP fromDashboard: type: boolean description: >- Whether the underlying transfer was initiated from the HIFI dashboard rather than the API. example: false initiatorProfileId: type: string description: Internal ID of the profile that initiated the transfer. votes: type: array items: $ref: '#/components/schemas/TransferApprovalVoteObject' createdAt: type: string format: date-time example: '2026-07-01T10:30:00.000Z' updatedAt: type: string format: date-time example: '2026-07-01T10:35:00.000Z' Unauthorized: type: object properties: type: type: string description: Unauthorized enum example: UNAUTHORIZED message: type: string description: Unauthorized message example: Authentication required NotFound: type: object properties: type: type: string example: RESOURCE_NOT_FOUND description: The error type, e.g., RESOURCE_NOT_FOUND message: type: string description: A descriptive error message fields: type: array description: List of specific field errors items: type: object properties: code: type: string description: Error code related to the field issue message: type: string description: Error message for the specific issue field: type: string description: The name of the field that has an issue ApiError: type: object description: >- Standard v3 error shape, returned by validation failures and business-logic errors alike. properties: type: type: string description: >- Machine-readable error type, e.g. VALIDATION_ERROR, ACTION_NOT_ALLOWED, RESOURCE_CONFLICT. example: VALIDATION_ERROR message: type: string description: Human-readable error message. example: One or more fields are invalid or missing. fields: type: array description: >- Present on field-level validation errors. One entry per problem field. items: type: object properties: code: type: string description: Error code related to the field issue. message: type: string description: Error message for the specific issue. field: type: string description: The name of the field that has an issue. InternalServerError: type: object properties: type: type: string example: INTERNAL_SERVER_ERROR description: Internal server error enum message: type: string example: An internal server error occurred description: Internal server error message TransferApprovalVoteObject: type: object description: A single approve/reject vote cast on a transfer approval. properties: approverId: type: string description: Internal ID of the approving profile member. vote: type: string enum: - APPROVE - REJECT example: APPROVE comment: type: string nullable: true example: Confirmed with finance. createdAt: type: string format: date-time example: '2026-07-01T10:35:00.000Z' securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: JWT ````