> ## Documentation Index
> Fetch the complete documentation index at: https://developer.fin.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Delete Beneficiary V3

> Delete a beneficiary so it can no longer be used for new payouts.

> [!WARNING]
>
> A delete cannot be undone. To use the same bank account again, create a new beneficiary with the same details.

## What happens after a delete

| Area | Behavior |
| - | - |
| Beneficiary list | The beneficiary is no longer returned. |
| Beneficiary details | Fetching the beneficiary returns `404`. |
| New payouts | Batch transactions and transfer payout create or settle return a validation error: `beneficiary is deleted`. |
| Transactions in progress | They still complete. |
| Deposits to its liquidation address | Funds are held at the address. No payout is made. |

## Errors

| Status | When |
| - | - |
| `404` | The beneficiary does not exist, or it belongs to another client. |
| `422` | The beneficiary is already deleted, or `beneficiary_id` is not a valid UUID. |


## OpenAPI

````yaml DELETE /v3/beneficiaries/{beneficiary_id}
openapi: 3.1.0
info:
  title: Fin.com API
  version: 1.0.0
  description: >-
    A simple API specification for Fin.com, a financial services platform that
    provides a range of banking and payment solutions for businesses and
    individuals. This API allows developers to integrate Fin.com's services into
    their applications, enabling functionalities such as customer management,
    transaction processing, and access to financial data.
servers:
  - url: https://sandbox.api.fin.com
    description: Sandbox server
  - url: https://api.fin.com
    description: Production server
security: []
tags:
  - name: Authentication
    description: A modified OAuth 2.0 Client Credential Flow
  - name: Customers
    description: Customer management and document upload operations
  - name: Balances
    description: Retrieve wallet balance information
  - name: Catalogue
    description: |
      A set of endpoints to retrieve contextual data to assemble requests
      to fin.com's API
  - name: Beneficiaries
    description: Manage beneficiary accounts for payments and transfers
  - name: Transactions
    description: Transaction history and management for beneficiaries
  - name: Virtual Accounts
    description: Create and manage virtual accounts for USD to USDC conversions
  - name: Fees & FX Rates
    description: Retrieve fees and foreign exchange rates
  - name: Crypto Orchestration
    description: >-
      Accept crypto deposits from exchange and external wallets and settle them
      to a destination wallet
paths:
  /v3/beneficiaries/{beneficiary_id}:
    delete:
      tags:
        - Beneficiaries
      summary: Delete Beneficiary V3
      description: >-
        Delete a beneficiary so it can no longer be used for new payouts. A
        delete cannot be undone.
      parameters:
        - name: beneficiary_id
          in: path
          required: true
          description: ID of the beneficiary to delete.
          schema:
            type: string
            format: uuid
          example: 3f6c2a1e-8b4d-4c2a-9e1f-7a5b6c8d9e01
      responses:
        '200':
          description: Beneficiary deleted.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    example: Deleted successfully
        '401':
          description: The token is missing, invalid or expired.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FinErrorResponse'
              example:
                message: Authentication failed!
                error:
                  code: 401
                  type: FIN_ERROR
                  message: Authentication failed
                  details: []
        '403':
          description: Client access is paused.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/FinErrorResponse'
              example:
                message: Access paused!
                error:
                  code: 403
                  type: FIN_ERROR
                  message: >-
                    Access paused for a past due invoice. Please pay to restore
                    access, or contact finance@fin.com with questions.
                  details: []
        '404':
          description: The beneficiary does not exist or does not belong to your client.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  errors:
                    type: array
                    items:
                      type: object
              example:
                message: Beneficiary not found
                errors: []
        '422':
          description: >-
            The `beneficiary_id` is not a valid UUID, or the beneficiary is
            already deleted.
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                  errors:
                    type: array
                    items:
                      type: object
                      additionalProperties:
                        type: string
              examples:
                already_deleted:
                  summary: Beneficiary already deleted
                  value:
                    message: Validation failed!
                    errors:
                      - beneficiary_id: Beneficiary is already deleted
                invalid_uuid:
                  summary: Invalid beneficiary ID
                  value:
                    message: Validation failed!
                    errors:
                      - beneficiary_id: Must be a valid UUID
      security:
        - bearerAuth: []
components:
  schemas:
    FinErrorResponse:
      type: object
      properties:
        message:
          type: string
        error:
          type: object
          properties:
            code:
              type: integer
            type:
              type: string
              enum:
                - FIN_ERROR
            message:
              type: string
            details:
              type: array
              items:
                type: object
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT
      description: >-
        Bearer token authentication. Obtain token from [Issue a
        Token](https://developer.fin.com/api-reference/authentication/issue-a-token)
        endpoint

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.