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

# Investor form options

> The dropdown catalog for the investor creation form: every enum POST /api/investors/v1 accepts that a UI should render as a dropdown rather than free text (holding types, tax statuses grouped RESIDENT/NRI for the resident-vs-NRI cascade, genders, KYC types, occupations, contact relations, bank account types, demat modes, nominee/guardian relationships, and the FATCA wealth-source / income-slab / occupation / PEP tables). Countries and states have their own endpoints.



## OpenAPI

````yaml /openapi.yaml get /api/masters/v1/investor-options
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/masters/v1/investor-options:
    get:
      tags:
        - masters
      summary: Investor form options
      description: >-
        The dropdown catalog for the investor creation form: every enum POST
        /api/investors/v1 accepts that a UI should render as a dropdown rather
        than free text (holding types, tax statuses grouped RESIDENT/NRI for the
        resident-vs-NRI cascade, genders, KYC types, occupations, contact
        relations, bank account types, demat modes, nominee/guardian
        relationships, and the FATCA wealth-source / income-slab / occupation /
        PEP tables). Countries and states have their own endpoints.
      responses:
        '200':
          content:
            application/json:
              schema:
                properties:
                  bank_account_types:
                    description: SB | CB | NE | NO.
                    type: array
                  contact_relations:
                    description: contact.email_relation / mobile_relation vocabulary.
                    type: array
                  demat_modes:
                    description: PHYSICAL | CDSL | NSDL.
                    type: array
                  fatca_occupation_types:
                    description: fatca.occupation_type vocabulary.
                    type: array
                  genders:
                    description: M | F | O.
                    type: array
                  guardian_relations:
                    description: FATHER | MOTHER | COURT_APPOINTED.
                    type: array
                  holding_types:
                    description: SINGLE | JOINT | ANYONE_OR_SURVIVOR.
                    type: array
                  income_slabs:
                    description: >-
                      fatca.income_slab — the exchange's Applicant Income Range
                      codes.
                    type: array
                  kyc_types:
                    description: KRA | CKYC | EKYC.
                    type: array
                  nominee_relationships:
                    description: nominees[].relationship vocabulary.
                    type: array
                  occupations:
                    description: primary_holder.occupation vocabulary.
                    type: array
                  pep_options:
                    description: fatca.pep — YES | NO | RELATED.
                    type: array
                  tax_statuses:
                    description: >-
                      The three form-supported tax statuses, grouped
                      RESIDENT/NRI.
                    type: array
                  wealth_sources:
                    description: fatca.source_of_wealth vocabulary.
                    type: array
                type: object
          description: Investor form dropdown catalog
components:
  securitySchemes:
    bearerAuth:
      bearerFormat: Opaque bearer token from POST /api/auth/v1/token
      scheme: bearer
      type: http

````