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

# Register investor

> Persists the investor and queues NSE UCC registration (plus FATCA submission, if supplied) asynchronously — returns status PENDING immediately.



## OpenAPI

````yaml /openapi.yaml post /api/investors/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: []
paths:
  /api/investors/v1/:
    post:
      tags:
        - investors
      summary: Register investor
      description: >-
        Persists the investor and queues NSE UCC registration (plus FATCA
        submission, if supplied) asynchronously — returns status PENDING
        immediately.
      requestBody:
        content:
          application/json:
            schema:
              properties:
                address:
                  type: object
                bank_accounts:
                  type: array
                client_ref:
                  type: string
                contact:
                  type: object
                demat:
                  type: object
                euin:
                  type: object
                fatca:
                  type: object
                guardian:
                  type: object
                holding_type:
                  description: SINGLE | JOINT | ANYONE_OR_SURVIVOR.
                  type: string
                joint_holders:
                  type: array
                nominees:
                  type: array
                primary_holder:
                  type: object
                sub_broker_code:
                  type: string
                tax_status:
                  description: >-
                    INDIVIDUAL | NRI_REPATRIABLE | NRI_NON_REPATRIABLE | MINOR |
                    HUF | COMPANY | TRUST.
                  type: string
              type: object
        description: Investor
      responses:
        '201':
          content:
            application/json:
              schema:
                properties:
                  client_ref:
                    type: string
                  created_at:
                    type: string
                  id:
                    type: string
                  provider:
                    type: string
                  providers:
                    type: array
                  status:
                    description: >-
                      PENDING | PROCESSING | REGISTERED | REJECTED. NSE
                      registration happens asynchronously after creation — poll
                      GET or listen for the
                      investor.registered/investor.rejected webhook events.
                    type: string
                type: object
          description: Investor queued for NSE provisioning

````