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

# Initiate Internal Transfer

> Initiate Internal Transfer



## OpenAPI

````yaml post /v2/transfer/internal
openapi: 3.1.0
info:
  title: FinHost WLB Client API
  description: FinHost WLB Client API
  version: 2.0.0
servers:
  - url: https://client-api.dev.finhost.io
security: []
tags:
  - name: contracts
    description: Contracts
  - name: clients
    description: Clients
  - name: companies
    description: Companies
  - name: accounts
    description: Accounts
  - name: recipients
    description: Recipients
  - name: transfer
    description: Transfer operations
  - name: exchange
    description: Exchange operations
paths:
  /v2/transfer/internal:
    post:
      tags:
        - transfer
      summary: Initiate Internal Transfer
      description: Initiate Internal Transfer
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              additionalProperties: false
              required:
                - amount
                - from
                - recipient
              properties:
                amount:
                  description: >-
                    Amount in integer/float string format with maximum 2 decimal
                    places
                  type: string
                  minLength: 1
                  maxLength: 14
                  examples:
                    - '42'
                    - '4.2'
                    - '4.20'
                from:
                  oneOf:
                    - description: Individual account from which the transfer will be made
                      type: object
                      additionalProperties: false
                      required:
                        - type
                        - accountId
                      properties:
                        type:
                          type: string
                          enum:
                            - individual
                        accountId:
                          type: string
                          format: uuid
                    - description: Company account from which the transfer will be made
                      type: object
                      additionalProperties: false
                      required:
                        - type
                        - accountId
                        - companyId
                      properties:
                        type:
                          type: string
                          enum:
                            - company
                        accountId:
                          type: string
                          format: uuid
                        companyId:
                          type: string
                          format: uuid
                recipient:
                  oneOf:
                    - allOf:
                        - description: Recipient account
                          type: object
                          additionalProperties: false
                          required:
                            - type
                            - accountId
                          properties:
                            type:
                              type: string
                              enum:
                                - account
                            accountId:
                              type: string
                              format: uuid
                            searchBy:
                              type: string
                              enum:
                                - alias
                                - email
                                - phone
                            reference:
                              description: Internal Reference
                              type: string
                              pattern: ^[A-Za-z0-9 ]{2,120}$
                              examples:
                                - internalreference
                    - allOf:
                        - description: Recipient persisted
                          type: object
                          additionalProperties: false
                          required:
                            - type
                            - key
                          properties:
                            type:
                              type: string
                              enum:
                                - persisted
                            key:
                              type: string
                              format: uuid
                            reference:
                              description: Internal Reference
                              type: string
                              pattern: ^[A-Za-z0-9 ]{2,120}$
                              examples:
                                - internalreference
      responses:
        '201':
          description: Created
          content:
            application/json:
              schema:
                type: object
                additionalProperties: false
                required:
                  - id
                  - operationId
                properties:
                  id:
                    description: Transaction ID
                    type: string
                    format: uuid
                  operationId:
                    description: Operation ID
                    type: string
                    format: uuid
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                oneOf:
                  - description: Amount is too big for this payment method
                    type: object
                    additionalProperties: false
                    required:
                      - message
                    properties:
                      message:
                        type: string
                        enum:
                          - Amount is too big for this payment method
                  - description: Account balance is not enough
                    type: object
                    additionalProperties: false
                    required:
                      - message
                    properties:
                      message:
                        type: string
                        enum:
                          - Account balance is not enough
                  - description: Account contract is not acceptable
                    type: object
                    additionalProperties: false
                    required:
                      - message
                    properties:
                      message:
                        type: string
                        enum:
                          - Account contract is not acceptable
                  - description: Account contracts quota is over provided limits
                    type: object
                    additionalProperties: false
                    required:
                      - message
                    properties:
                      message:
                        type: string
                        enum:
                          - Account contracts quota is over provided limits
                  - description: Persisted recipient does not support this payment method
                    type: object
                    additionalProperties: false
                    required:
                      - message
                    properties:
                      message:
                        type: string
                        enum:
                          - >-
                            Persisted recipient does not support this payment
                            method
                  - description: Recipient account configuration is not acceptable
                    type: object
                    additionalProperties: false
                    required:
                      - message
                    properties:
                      message:
                        type: string
                        enum:
                          - Recipient account configuration is not acceptable
                  - description: Recipient account contract is not acceptable
                    type: object
                    additionalProperties: false
                    required:
                      - message
                    properties:
                      message:
                        type: string
                        enum:
                          - Recipient account contract is not acceptable
                  - description: Recipient account currency does not match
                    type: object
                    additionalProperties: false
                    required:
                      - message
                    properties:
                      message:
                        type: string
                        enum:
                          - Recipient account currency does not match
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                oneOf:
                  - description: Sender has no contract
                    type: object
                    additionalProperties: false
                    required:
                      - message
                    properties:
                      message:
                        type: string
                        enum:
                          - Sender has no contract
                  - description: Sender has no access to this account
                    type: object
                    additionalProperties: false
                    required:
                      - message
                    properties:
                      message:
                        type: string
                        enum:
                          - Sender has no access to this account
                  - description: Account has no access to this product
                    type: object
                    additionalProperties: false
                    required:
                      - message
                    properties:
                      message:
                        type: string
                        enum:
                          - Account has no access to this product
                  - description: Account is not active
                    type: object
                    additionalProperties: false
                    required:
                      - message
                    properties:
                      message:
                        type: string
                        enum:
                          - Account is not active
                  - description: Recipient is blocked
                    type: object
                    additionalProperties: false
                    required:
                      - message
                    properties:
                      message:
                        type: string
                        enum:
                          - Recipient is blocked
                  - description: Recipient account has no access to this product
                    type: object
                    additionalProperties: false
                    required:
                      - message
                    properties:
                      message:
                        type: string
                        enum:
                          - Recipient account has no access to this product
                  - description: Recipient account is not active
                    type: object
                    additionalProperties: false
                    required:
                      - message
                    properties:
                      message:
                        type: string
                        enum:
                          - Recipient account is not active
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                oneOf:
                  - description: Sender not found
                    type: object
                    additionalProperties: false
                    required:
                      - message
                    properties:
                      message:
                        type: string
                        enum:
                          - Sender not found
                  - description: Persisted recipient not found
                    type: object
                    additionalProperties: false
                    required:
                      - message
                    properties:
                      message:
                        type: string
                        enum:
                          - Persisted recipient not found
                  - description: Recipient account not found
                    type: object
                    additionalProperties: false
                    required:
                      - message
                    properties:
                      message:
                        type: string
                        enum:
                          - Recipient account not found
      security:
        - bearerAuth: []
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````