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

# Get Mobile Numbers

> Retrieve your purchased/rented mobile numbers

## Overview

Get the list of mobile phone numbers purchased or rented by the API key owner. These numbers can be assigned to agents for inbound/outbound telephony calls.

## Authentication

<ParamField header="X-API-Key" type="string" required>
  Your eigi.ai API key. Must be prefixed with `vk_`.
</ParamField>

## Response

<ResponseField name="user_id" type="string">
  Your user ID.
</ResponseField>

<ResponseField name="purchased_mobile_numbers" type="array">
  Array of mobile number objects, each containing:

  * `mobile_number` (string): Phone number in E.164 format (e.g., `+919876543210`)
  * `telephony_provider` (string): Provider (`PLIVO` or `TWILIO`)
</ResponseField>


## OpenAPI

````yaml GET /v1/public/mobile-numbers
openapi: 3.0.0
info:
  title: eigi.ai API
  description: REST API for managing AI voice agents and conversations
  version: 1.0.0
  contact:
    email: buddy@eigi.ai
    url: https://eigi.ai
servers:
  - url: https://api.eigi.ai
    description: Production server
security:
  - ApiKeyAuth: []
paths:
  /v1/public/mobile-numbers:
    get:
      tags:
        - Utilities
      summary: Get Mobile Numbers
      description: >-
        Retrieve the API key owner's purchased/rented mobile numbers with
        telephony provider information.
      operationId: getMobileNumbers
      responses:
        '200':
          description: Successfully retrieved mobile numbers
          content:
            application/json:
              schema:
                type: object
                properties:
                  user_id:
                    type: string
                    description: User ID
                  purchased_mobile_numbers:
                    type: array
                    items:
                      type: object
                      properties:
                        mobile_number:
                          type: string
                          description: Phone number in E.164 format
                        telephony_provider:
                          type: string
                          description: Provider (PLIVO, TWILIO)
                    description: List of purchased mobile numbers
        '401':
          description: Unauthorized - Invalid API key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - ApiKeyAuth: []
components:
  schemas:
    Error:
      type: object
      properties:
        detail:
          type: string
          description: Error message
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
      description: >-
        API key for authentication. Get your API key from the eigi.ai Dashboard
        under Settings → API Keys.

````