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

# Batch delete accounts by IBANs

> Deletes multiple accounts using their IBANs.



## OpenAPI

````yaml delete /v1/accounts/ibans
openapi: 3.0.1
info:
  description: Verification of Payee (VoP) API for SEPA payment validation
  title: VoP Verifier API
  version: 1.0.0
servers:
  - description: VoP test environment
    url: https://api.vop-sandbox.finventi.com
  - description: VoP prod environment
    url: https://api.vop.finventi.com
security: []
tags:
  - description: >-
      Endpoints for creating, updating, and deleting IBAN-to-account-holder
      records. Used by data providers to keep verification data accurate and up
      to date.
    name: Accounts management
paths:
  /v1/accounts/ibans:
    delete:
      tags:
        - Accounts management
      summary: Batch delete of accounts by IBANs or Client IDs
      description: >-
        Deletes all accounts matching any of the IBANs or Client IDs provided in
        the request body. Only one list (either ibans or clientIds) must be
        provided
      operationId: deleteAccountsByIbans
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/DeleteAccountsByIbansRequest'
        description: >-
          Payload containing: `ibans`: list of IBANs to delete;`clientIds`: list
          of Client IDs to delete. Either ibans or clientIds must be provided.
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchDeleteByIbanResponse'
          description: Batch deletion result
        '400':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
          description: Bad request
        '403':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
          description: Tenant does not have access to the resource
components:
  schemas:
    DeleteAccountsByIbansRequest:
      properties:
        ibans:
          description: List of IBANs to delete
          example:
            - LT121000011101001000
            - DE89370400440532013000
          items:
            description: List of IBANs to delete
            example: '["LT121000011101001000","DE89370400440532013000"]'
            type: string
          minItems: 1
          type: array
          uniqueItems: true
      required:
        - ibans
      type: object
    BatchDeleteByIbanResponse:
      properties:
        deleted_count:
          description: Number of IBANs successfully deleted
          example: 2
          format: int32
          type: integer
        deleted_ibans:
          description: List of IBANs successfully deleted
          example:
            - LT121000011101001000
            - DE89370400440532013000
          items:
            description: List of IBANs successfully deleted
            example: '["LT121000011101001000","DE89370400440532013000"]'
            type: string
          type: array
          uniqueItems: true
        failed_count:
          description: Number of IBANs that failed to delete
          example: 1
          format: int32
          type: integer
        failed_entries:
          description: Details of IBANs that failed to delete, with reasons
          properties:
            iban:
              description: IBAN that failed to delete
              example: LT121000011101001000
              type: string
            reason:
              description: Reason why deletion failed
              example: Account not found
              type: string
          required:
            - iban
            - reason
          type: object
        total_count:
          description: Total number of IBANs submitted for deletion
          example: 3
          format: int32
          type: integer
      required:
        - deleted_count
        - deleted_ibans
        - failed_count
        - failed_entries
        - total_count
      type: object
    Problem:
      properties:
        detail:
          type: string
        instance:
          format: uri
          type: string
        parameters:
          additionalProperties:
            type: object
          type: object
        status:
          $ref: '#/components/schemas/StatusType'
        title:
          type: string
        type:
          format: uri
          type: string
      type: object
    StatusType:
      properties:
        reasonPhrase:
          type: string
        statusCode:
          format: int32
          type: integer
      type: object

````