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

# New User Registration

> New User Registration is Made



## OpenAPI

````yaml /open-api/en/auth-version-1.json post /v1/auth/register
openapi: 3.0.1
info:
  title: OpenAPI definition
  version: v0
servers:
  - url: https://api.iklim.co
    description: Production server
  - url: https://api-test.iklim.co
    description: Test server
  - url: http://localhost:8080
    description: Local development environment with api gateway
security: []
tags:
  - name: User Service
    description: Manages User Related Services
  - name: Authentication Service
    description: Manages Authentication Operations
paths:
  /v1/auth/register:
    post:
      tags:
        - Authentication Service
      summary: New User Registration
      description: New User Registration is Made
      operationId: register
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/RegisterUserRequest'
        required: true
      responses:
        '200':
          description: Successful User Registration
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/RegisterUserRequest'
        '400':
          description: Required Headers Missing or Payload Invalid for Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardErrorResponse'
              examples:
                Bad Request Example:
                  summary: Example response
                  description: Bad Request Example
                  value:
                    timestamp: '2025-04-14T16:26:54.203118461'
                    status: 400
                    error: Bad Request
                    message: Missing X-Idempotency-Key header
                    path: /endpoint/uri/here
        '401':
          description: Unauthorized Request or Invalid Signature
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardErrorResponse'
              examples:
                Unauthorized Example 1:
                  summary: Example response 1
                  description: Unauthorized Example 1
                  value:
                    timestamp: '2025-04-14T16:57:50.083970026'
                    status: 401
                    error: Unauthorized
                    message: Bad Credentials
                    path: /endpoint/uri/here
                Unauthorized Example 2:
                  summary: Example response 2
                  description: Unauthorized Example 2
                  value:
                    timestamp: '2025-04-14T16:57:50.083970026'
                    status: 401
                    error: Unauthorized
                    message: Invalid request signature
                    path: /auth/login
        '403':
          description: Forbidden
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/StandardErrorResponse'
        '409':
          description: Redundant Request Made
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardErrorResponse'
              examples:
                Conflict Example 1:
                  summary: Example response 1
                  description: Conflict Example 1
                  value:
                    timestamp: '2025-04-14T16:57:21.168927321'
                    status: 409
                    error: Conflict
                    message: Replay attack detected (nonce reused)
                    path: /endpoint/uri/here
                Conflict Example 2:
                  summary: Example response 2
                  description: Conflict Example 2
                  value:
                    timestamp: '2025-04-14T16:56:28.671809875'
                    status: 409
                    error: Conflict
                    message: Duplicate request detected (X-Idempotency-Key)
                    path: /endpoint/uri/here
        '500':
          description: Internal Server Error During Request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/StandardErrorResponse'
              examples:
                Internal Server Error Example:
                  summary: Example response
                  description: Internal Server Error Example
                  value:
                    timestamp: '2025-04-14T16:58:10.414972912'
                    status: 500
                    error: Internal Server Error
                    message: An Error Occurred During Login
                    path: /endpoint/uri/here
components:
  schemas:
    RegisterUserRequest:
      required:
        - firstName
        - lastName
        - locale
        - timezone
        - username
      type: object
      properties:
        username:
          type: string
          description: User Name in E-Mail Format for Registration
          example: name@domain.com
        password:
          type: string
          description: Password for Registration
          example: password
        firstName:
          type: string
          description: First Name for Registration
          example: John
        midName:
          type: string
          description: Mid Name for Registration
          example: Bob
        lastName:
          type: string
          description: Last Name for Registration
          example: Doe
        locale:
          type: string
          description: User Locale for Registration
          example: tr_TR
        timezone:
          type: string
          description: >-
            User Timezone Id.

            You Can Find a List of 'TZ identifier' on page
            https://en.wikipedia.org/wiki/List_of_tz_database_time_zones
          example: Europe/Istanbul
    StandardErrorResponse:
      required:
        - error
        - message
        - path
        - status
        - timestamp
      type: object
      properties:
        timestamp:
          type: string
          description: Error Time Stamp
          format: date-time
        status:
          type: integer
          description: Error Status Code
          format: int32
        error:
          type: string
          description: Error Name
          example: Error Name
        message:
          type: string
          description: Error Description
          example: Error Message
        path:
          type: string
          description: Erroring Endpoint URI
          example: /endpoint/uri/here

````