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

# Create investment account

> Creates a named account for an investor and mints a friendly ID (A_<CC>_<seq>).



## OpenAPI

````yaml /openapi.yaml post /api/investment-accounts/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/investment-accounts/v1/:
    post:
      tags:
        - investment-accounts
      summary: Create investment account
      description: >-
        Creates a named account for an investor and mints a friendly ID
        (A_<CC>_<seq>).
      requestBody:
        content:
          application/json:
            schema:
              properties:
                code:
                  description: >-
                    Caller-supplied 2-character code (A-Z, 0-9), e.g. RT.
                    Becomes part of the account ID.
                  type: string
                investor_id:
                  description: Friendly investor ID, e.g. I_SI_IND_000001.
                  type: string
                name:
                  description: Optional human-friendly label, e.g. Retirement.
                  type: string
              type: object
        description: Investment account
      responses:
        '201':
          content:
            application/json:
              schema:
                properties:
                  code:
                    type: string
                  created_at:
                    type: string
                  id:
                    description: Friendly account ID, e.g. A_RT_000001.
                    type: string
                  investor_id:
                    type: string
                  name:
                    type: string
                  status:
                    description: ACTIVE.
                    type: string
                type: object
          description: Created

````