> ## 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.

# Patch account details by Client ID

> Updates account holder name or legal entity information for the specified client ID.



## OpenAPI

````yaml put /v1/accounts/client/{clientId}
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/client/{clientId}:
    put:
      tags:
        - Accounts management
      summary: Patch account details by Client Id
      description: >-
        Updates accountHolderName or legal entity info for the given client
        identifier.
      operationId: updateAccountByClientId
      parameters:
        - description: Client identifier of the account to update
          example: client-12345
          in: path
          name: clientId
          required: true
          schema:
            type: string
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateAccountRequest'
        description: Fields to update for the account
        required: true
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchAccountUpdateResponse'
          description: The list of accounts that were updated
        '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
        '404':
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
          description: Account not found
components:
  schemas:
    UpdateAccountRequest:
      properties:
        account_holder_names:
          description: New account holder name. Optional; if provided must not be blank.
          example:
            - Bob Smith
          items:
            description: New account holder name. Optional; if provided must not be blank.
            example: '["Bob Smith"]'
            type: string
          minItems: 1
          type: array
        aliases:
          description: >-
            Optional alternative names or identifiers to improve matching (e.g.,
            acronyms, short forms like "IBM" for "International Business
            Machines")
          example:
            - HGRP
          items:
            description: >-
              Optional alternative names or identifiers to improve matching
              (e.g., acronyms, short forms like "IBM" for "International
              Business Machines")
            example: '["HGRP"]'
            type: string
          type: array
        organisation_identification:
          $ref: '#/components/schemas/OrganisationIdentification'
      required:
        - account_holder_names
      type: object
    BatchAccountUpdateResponse:
      properties:
        accounts:
          items:
            $ref: '#/components/schemas/ImportedEntryResponse'
          type: array
      required:
        - accounts
      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
    OrganisationIdentification:
      description: Legal-entity identifiers for the IBAN owner.
      properties:
        bic:
          description: >-
            Business Identifier Code (BIC). 11 characters, conforming to ISO
            9362 format.
          example: DEUTDEFFXXX
          type: string
        lei:
          description: Legal Entity Identifier (LEI) conforming to ISO 17442 format.
          example: 5493001KJTIIGC8Y1R12
          type: string
        other:
          $ref: '#/components/schemas/OtherOrganisationIdentificationRequest'
      type: object
    ImportedEntryResponse:
      description: List of account entries that were successfully imported
      properties:
        account_holder_names:
          description: Names of the account holders
          example:
            - Alice Johnson
          items:
            description: Names of the account holders
            example: '["Alice Johnson"]'
            type: string
          type: array
        aliases:
          description: >-
            Alternative names or identifiers to improve matching (e.g.,
            acronyms, short forms like "IBM" for "International Business
            Machines")
          example:
            - HGRP
          items:
            description: >-
              Alternative names or identifiers to improve matching (e.g.,
              acronyms, short forms like "IBM" for "International Business
              Machines")
            example: '["HGRP"]'
            type: string
          type: array
        client_id:
          description: Client identifier
          example: client-12345
          type: string
        iban:
          description: IBAN of the account
          example: LT121000011101001000
          type: string
        organisation_identification:
          $ref: '#/components/schemas/OrganisationIdentificationResponse'
      required:
        - account_holder_names
        - aliases
        - iban
      type: object
    StatusType:
      properties:
        reasonPhrase:
          type: string
        statusCode:
          format: int32
          type: integer
      type: object
    OtherOrganisationIdentificationRequest:
      description: Custom identification scheme for organisations.
      properties:
        identification:
          description: Identifier value in this custom scheme.
          example: 123-ABC-XYZ
          maxLength: 256
          minLength: 1
          type: string
        issuer:
          description: Authority or body that issued this identifier.
          example: ChamberOfCommerce
          type: string
        scheme_name_code:
          description: Coded name of the identifier scheme
          enum:
            - BANK
            - CBID
            - CHID
            - CINC
            - COID
            - CUST
            - DUNS
            - EMPL
            - GS1G
            - SREN
            - SRET
            - TXID
            - BDID
            - BOID
          example: BANK
          type: string
        scheme_name_proprietary:
          description: Proprietary name of the identifier scheme.
          example: LocalRegistry
          type: string
      required:
        - identification
      type: object
    OrganisationIdentificationResponse:
      description: Identification details for the organisation.
      properties:
        bic:
          description: >-
            Business Identifier Code (BIC) 11 characters, conforming to ISO 9362
            format.
          example: DEUTDEFFXXX
          type: string
        lei:
          description: Legal Entity Identifier (LEI) conforming to ISO 17442 format.
          example: 5493001KJTIIGC8Y1R12
          type: string
        other:
          $ref: '#/components/schemas/OtherOrganisationIdentificationResponse'
      type: object
    OtherOrganisationIdentificationResponse:
      description: Custom identification scheme for organisations.
      properties:
        identification:
          description: Identifier value in this custom scheme.
          example: 123-ABC-XYZ
          maxLength: 256
          minLength: 1
          type: string
        issuer:
          description: Authority or body that issued this identifier.
          example: ChamberOfCommerce
          type: string
        scheme_name_code:
          description: Coded name of the identifier scheme
          example: VAT
          type: string
        scheme_name_proprietary:
          description: Proprietary name of the identifier scheme.
          example: LocalRegistry
          type: string
      required:
        - identification
      type: object

````