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

# Get a Manual Bank Account's Details to Edit

> Get the current details of a bank account that was added with its routing and
account number, so they can be shown in an edit form and corrected with
``PATCH /platform/bank/update/{bank_account_id}``.

The account number comes back in full — these are the numbers you entered.
It is decrypted only for this request; never log or cache it.

Refused with `bank_not_editable` for any bank the edit itself refuses (one
verified instantly, removed, or not a domestic bank added with its numbers).



## OpenAPI

````yaml GET /v1/platform/bank/update/{bank_account_id}
openapi: 3.1.0
info:
  title: Finogate Platform API v1
  version: 0.1.0
servers:
  - url: https://api-sandbox.finogates.com
    description: Sandbox
  - url: https://api.finogates.com
    description: Production
security: []
tags:
  - name: auth
  - name: users
  - name: payees
  - name: verification
  - name: bank accounts
  - name: card processing
  - name: digital-assets
  - name: international
  - name: fees
  - name: emails
  - name: email-templates
  - name: onboarding
  - name: Redirect URLs
  - name: pending-applications
  - name: feature requests
  - name: integration apps
  - name: wallets
  - name: payments
  - name: document mailing
  - name: merchant onboarding
  - name: catalog
  - name: webhooks
  - name: screening
  - name: Platform - File Scanning
  - name: phone-numbers
  - name: sms
  - name: calls
  - name: listings
  - name: Card Transfers
  - name: Card Transfers (Sandbox)
  - name: Accounting
  - name: check payments
  - name: check designs
  - name: embed-tokens
paths:
  /v1/platform/bank/update/{bank_account_id}:
    get:
      tags:
        - bank accounts
      summary: Get a Manually Added Bank Account's Details to Edit
      description: >-
        Get the current details of a bank account that was added with its
        routing and

        account number, so they can be shown in an edit form and corrected with

        ``PATCH /platform/bank/update/{bank_account_id}``.


        The account number comes back in full — these are the numbers you
        entered.

        It is decrypted only for this request; never log or cache it.


        Refused with `bank_not_editable` for any bank the edit itself refuses
        (one

        verified instantly, removed, or not a domestic bank added with its
        numbers).
      operationId: get_bank_account_for_edit_v1_platform_bank_update__bank_account_id__get
      parameters:
        - name: bank_account_id
          in: path
          required: true
          schema:
            type: string
            format: uuid
            description: The unique ID of the manually added bank account to edit.
            examples:
              - e5f6a7b8-c9d0-1234-5678-9abcdef01234
            title: Bank Account Id
          description: The unique ID of the manually added bank account to edit.
      responses:
        '200':
          description: The bank's current details, numbers in full.
          content:
            application/json:
              schema:
                $ref: >-
                  #/components/schemas/CommonResponse_PlatformBankAccountEditRead_
              example:
                status_code: 200
                data:
                  payment_method_id: e5f6a7b8-c9d0-1234-5678-9abcdef01234
                  user_id: b3a9b622-cc63-4d3c-aad6-2d8e29e6f9d4
                  account_holder_name: John Doe
                  bank_account_number: '1234567890'
                  routing_number: '021000021'
                  account_type: checking
                  bank_name: Example Bank
                query_generated_time: 1712847600000
        '409':
          description: bank_not_editable
          content:
            application/json:
              examples:
                bank_not_editable:
                  summary: bank_not_editable (error_code 1127)
                  value:
                    status_code: 409
                    data:
                      detail: >-
                        Only a bank account added with its account and routing
                        numbers, and not yet verified, can be edited.
                      code: bank_not_editable
                      error_code: 1127
                    query_generated_time: 1750000000000
              schema:
                $ref: '#/components/schemas/CodedErrorResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - _AuthenticatedBearer: []
components:
  schemas:
    CommonResponse_PlatformBankAccountEditRead_:
      properties:
        status_code:
          type: integer
          title: Status Code
          description: HTTP status code for the response.
        data:
          $ref: '#/components/schemas/PlatformBankAccountEditRead'
          description: Payload or error details.
        query_generated_time:
          type: integer
          title: Query Generated Time
          description: >-
            UTC timestamp (milliseconds since epoch) when response was
            generated.
      type: object
      required:
        - status_code
        - data
        - query_generated_time
      title: CommonResponse[PlatformBankAccountEditRead]
    CodedErrorResponse:
      properties:
        status_code:
          type: integer
          title: Status Code
          description: HTTP status code for the response.
        data:
          $ref: '#/components/schemas/CodedErrorBody'
          description: Payload or error details.
        query_generated_time:
          type: integer
          title: Query Generated Time
          description: >-
            UTC timestamp (milliseconds since epoch) when response was
            generated.
      type: object
      required:
        - status_code
        - data
        - query_generated_time
      title: CodedErrorResponse
      description: Standard envelope wrapping a :class:`CodedErrorBody`.
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    PlatformBankAccountEditRead:
      properties:
        payment_method_id:
          type: string
          format: uuid
          title: Payment Method Id
          examples:
            - e5f6a7b8-c9d0-1234-5678-9abcdef01234
        user_id:
          type: string
          format: uuid
          title: User Id
          examples:
            - b3a9b622-cc63-4d3c-aad6-2d8e29e6f9d4
        account_holder_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Account Holder Name
          examples:
            - John Doe
        bank_account_number:
          anyOf:
            - type: string
            - type: 'null'
          title: Bank Account Number
          description: The full account number; null when it cannot be read back.
          examples:
            - '1234567890'
        routing_number:
          anyOf:
            - type: string
            - type: 'null'
          title: Routing Number
          examples:
            - '021000021'
        account_type:
          anyOf:
            - type: string
            - type: 'null'
          title: Account Type
          examples:
            - checking
        bank_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Bank Name
          examples:
            - Example Bank
      type: object
      required:
        - payment_method_id
        - user_id
      title: PlatformBankAccountEditRead
      description: >-
        The values an edit of a manually added bank starts from.


        Unlike every other bank read, the account number is in full: these are
        the

        numbers the platform itself typed in, handed back so they can be
        corrected.
    CodedErrorBody:
      properties:
        detail:
          type: string
          title: Detail
          description: Human-readable error message.
        code:
          type: string
          title: Code
          description: Stable string error code — the canonical value to branch on.
        error_code:
          type: integer
          title: Error Code
          description: >-
            Numeric custom error code from the Finogate registry. Unique per
            condition and stable forever.
      type: object
      required:
        - detail
        - code
        - error_code
      title: CodedErrorBody
      description: >-
        The ``data`` payload of a coded-error response.


        Condition-specific extras (e.g. ``remaining_time``) may also appear;
        only

        the always-present fields are typed here.
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    _AuthenticatedBearer:
      type: oauth2
      flows:
        password:
          scopes: {}
          tokenUrl: /v1/platform/auth/token

````

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