Skip to main content
GET
/
v1
/
public
/
mobile-numbers
Get Mobile Numbers
curl --request GET \
  --url https://api.eigi.ai/v1/public/mobile-numbers \
  --header 'X-API-Key: <api-key>'
{
  "user_id": "<string>",
  "purchased_mobile_numbers": [
    {
      "mobile_number": "<string>",
      "telephony_provider": "<string>"
    }
  ]
}

​
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

​
X-API-Key
string
required
Your eigi.ai API key. Must be prefixed with vk_.

​
Response

​
user_id
string
Your user ID.
​
purchased_mobile_numbers
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)

Authorizations

​
X-API-Key
string
header
required

API key for authentication. Get your API key from the eigi.ai Dashboard under Settings → API Keys.

Response

Successfully retrieved mobile numbers

​
user_id
string

User ID

​
purchased_mobile_numbers
object[]

List of purchased mobile numbers