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

# [BETA] Request broker change

> BETA. Files a change-of-broker request for an existing folio with the exchange. Wet-signature requests then need the signed form uploaded via POST /{id}/image.



## OpenAPI

````yaml /openapi.yaml post /api/broker-changes/v1/
openapi: 3.0.3
info:
  title: MF Atlas API
  version: 1.0.0
servers:
  - description: Sandbox
    url: https://api-sandbox.mf-atlas.space
  - description: Production
    url: https://api.mf-atlas.space
security:
  - bearerAuth: []
paths:
  /api/broker-changes/v1/:
    post:
      tags:
        - broker-changes (beta)
      summary: '[BETA] Request broker change'
      description: >-
        BETA. Files a change-of-broker request for an existing folio with the
        exchange. Wet-signature requests then need the signed form uploaded via
        POST /{id}/image.
      requestBody:
        content:
          application/json:
            schema:
              properties:
                amc_code:
                  description: AMC (fund house) code of the folio, max 3 characters.
                  type: string
                auth_mode:
                  description: >-
                    TWO_FACTOR | WET_SIGNATURE. WET_SIGNATURE requires uploading
                    the signed form via POST /api/broker-changes/v1/{id}/image.
                  type: string
                broker_code:
                  description: >-
                    New distributor ARN, e.g. ARN-12345. Required unless
                    ria_code is given.
                  type: string
                client_ref:
                  type: string
                email:
                  description: Primary holder email. Required for WET_SIGNATURE.
                  type: string
                euin:
                  description: Max 7 characters.
                  type: string
                folio_no:
                  description: Existing folio whose distributor is being changed.
                  type: string
                holder_name:
                  description: Primary holder name as on the folio, max 40 characters.
                  type: string
                investor_id:
                  description: >-
                    Friendly investor ID; its PAN is the primary-holder PAN on
                    the filing.
                  type: string
                mobile:
                  description: Primary holder mobile, max 15 characters.
                  type: string
                ria_code:
                  description: >-
                    New RIA code. Required when the investor moves to an RIA
                    instead of an ARN.
                  type: string
                sub_broker_code:
                  type: string
                two_fa_channel:
                  description: MOBILE | EMAIL | BOTH. Required for TWO_FACTOR.
                  type: string
              required:
                - amc_code
                - auth_mode
                - folio_no
                - investor_id
              type: object
        description: Broker change
        required: true
      responses:
        '201':
          content:
            application/json:
              schema:
                properties:
                  amc_code:
                    type: string
                  auth_mode:
                    type: string
                  broker_code:
                    type: string
                  client_ref:
                    type: string
                  created_at:
                    type: string
                  euin:
                    type: string
                  folio_no:
                    type: string
                  id:
                    type: string
                  investor_id:
                    type: string
                  pan:
                    description: Masked.
                    type: string
                  provider_remark:
                    type: string
                  ria_code:
                    type: string
                  status:
                    description: >-
                      PENDING_DOCUMENT (wet-signature form not yet uploaded) |
                      SUBMITTED | REJECTED.
                    type: string
                  sub_broker_code:
                    type: string
                  two_fa_channel:
                    type: string
                  updated_at:
                    type: string
                required:
                  - amc_code
                  - auth_mode
                  - created_at
                  - folio_no
                  - id
                  - investor_id
                  - pan
                  - status
                  - updated_at
                type: object
          description: Filed request
components:
  securitySchemes:
    bearerAuth:
      bearerFormat: Opaque bearer token from POST /api/auth/v1/token
      scheme: bearer
      type: http

````