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

# Request Phone Number Activation

> Starts the phone number activation process by sending a verification code to the user's phone.



## OpenAPI

````yaml /open-api/en/accounts-version-1.json post /v1/accounts/phone-number-activation-request
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 Accounts Service
    description: Manages Account Related Services
paths:
  /v1/accounts/phone-number-activation-request:
    post:
      tags:
        - User Accounts Service
      summary: Request Phone Number Activation
      description: >-
        Starts the phone number activation process by sending a verification
        code to the user's phone.
      operationId: activatePhoneNumberRequest
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PhoneNumberActivationRequest'
        required: true
      responses:
        '200':
          description: Phone Number Activation Request Successfully Sent
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PhoneNumberActivationResponse'
        '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:
    PhoneNumberActivationRequest:
      required:
        - accountId
        - phoneNumberActivationPageLink
        - userId
      type: object
      properties:
        userId:
          type: string
          description: User Identifier for Mobile Phone Activation
          format: uuid
          example: 296ff917-9b4b-4dc1-987d-2c17bdac7133
        accountId:
          type: string
          description: Account Identifier for Mobile Phone Activation
          format: uuid
          example: a5b5687b-ad68-44c1-b80c-c96de0d34b0a
        phoneNumberActivationPageLink:
          type: string
          description: Mobile Phone Activation Page Link
          example: https://api-manager.iklim.co/activation/mobile-phone-number
    PhoneNumberActivationResponse:
      type: object
      properties:
        userId:
          type: string
          description: User Identifier of Mobile Phone Activated User
        accountId:
          type: string
          description: Account Identifier of Mobile Phone Activated Account
        recipientPhoneNumber:
          type: string
          description: Mobile Phone Number to which SMS was Sent
        tokenExpirationEpoch:
          type: integer
          description: SMS Activation Token Expiration Time
          format: int64
        smsSent:
          type: boolean
          description: Was SMS Sent Successfully?
    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

````