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

# Register a new user account

> **System Function**: Creates a new user account in the DeFindex platform. 
    This endpoint allows new users to register for access to the DeFindex API. Upon successful registration, users receive authentication credentials that enable them to access protected endpoints and manage their DeFi investments.



## OpenAPI

````yaml POST /register
openapi: 3.0.0
info:
  title: DeFindex API
  description: API documentation for DeFindex endpoints
  version: 1.0.0
  contact: {}
  x-logo:
    url: https://links.paltalabs.io/defindex-full.svg
    backgroundColor: '#0e0e0e'
    altText: DeFindex Logo
    href: https://defindex.io
servers: []
security: []
tags: []
paths:
  /register:
    post:
      tags:
        - Auth
      summary: Register a new user account
      description: >-
        **System Function**: Creates a new user account in the DeFindex
        platform. 
            This endpoint allows new users to register for access to the DeFindex API. Upon successful registration, users receive authentication credentials that enable them to access protected endpoints and manage their DeFi investments.
      operationId: AuthController_register
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/AuthRegisterDto'
      responses:
        '201':
          description: User registered successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  message:
                    type: string
                    description: Confirmation message indicating successful registration
                example:
                  message: User defi_investor registered
        '400':
          description: Bad request - invalid registration data or user already exists
components:
  schemas:
    AuthRegisterDto:
      type: object
      properties:
        username:
          type: string
          example: defi_investor
          description: Username for the new account
        password:
          type: string
          example: SecurePassword123!
          description: User password
        email:
          type: string
          example: user@example.com
          description: User email address
      required:
        - username
        - password
        - email

````

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