Skip to main content
GET
/
v1
/
voice
/
phone-numbers
List Phone Numbers
curl --request GET \
  --url https://api.example.com/v1/voice/phone-numbers \
  --header 'X-API-Key: <x-api-key>'
{
  "success": true,
  "count": 123,
  "phone_numbers": [
    {
      "phone_number": "<string>",
      "pretty_phone_number": "<string>",
      "id": "<string>",
      "area_code": "<string>",
      "phone_type": "<string>",
      "provider": "<string>",
      "user_id": "<string>",
      "organization_id": "<string>",
      "tenant_id": "<string>",
      "outbound_agent_id": "<string>",
      "inbound_agent_id": "<string>",
      "nickname": "<string>",
      "location": "<string>",
      "accessible_by": [
        {}
      ],
      "stripe_subscription_id": "<string>",
      "zapier": true,
      "is_available": true,
      "campaign_id": "<string>",
      "created_at": {}
    }
  ],
  "powered_by": "<string>"
}

​
Description

Returns all voice phone numbers owned by a user or organization. Admin users see all organization phone numbers.

​
Authentication

​
X-API-Key
string
required
Your Teli API key

​
Query Parameters

​
user_id
string
required
User unique_id (phone numbers are user-owned)
​
organization_id
string
required
Organization unique_id
​
is_admin
boolean
default:"false"
If true, returns all org phone numbers. If false, returns only user’s phone numbers.
​
phone_type
string
Filter by phone type: voice or sms. If omitted, returns all types.

​
Response Fields

​
success
boolean
Whether the request was successful
​
count
integer
Total number of phone numbers
​
phone_numbers
array
Array of phone number objects
​
powered_by
string
Always returns “Teli”

​
Example Request

cURL
curl -X GET "https://api.teli.ai/v1/voice/phone-numbers?user_id=1762896366429x599348279945132448&organization_id=1762896364768x389173798861431550&is_admin=true&phone_type=voice" \
  -H "X-API-Key: YOUR_API_KEY"

​
Example Response

200
{
  "success": true,
  "count": 2,
  "phone_numbers": [
    {
      "phone_number": "+15174686941",
      "pretty_phone_number": "+1 517-468-6941",
      "id": "2fa5412b-c6a1-495f-b546-a3cadc0316d9",
      "area_code": "517",
      "phone_type": "voice",
      "provider": "teli_voice",
      "user_id": "0cf76f73-a751-4f65-b7bf-37f6cd5fdced",
      "organization_id": "4d051118-c116-4923-8ff4-1a9761115fec",
      "tenant_id": "your_tenant",
      "outbound_agent_id": "74014854-b110-46c8-b037-18f0149baae6",
      "inbound_agent_id": null,
      "nickname": null,
      "location": null,
      "accessible_by": null,
      "stripe_subscription_id": null,
      "zapier": false,
      "created_at": "2025-11-18T16:42:54.719787"
    },
    {
      "phone_number": "+12489071796",
      "pretty_phone_number": "+1 248-907-1796",
      "id": "55027d16-d590-41d9-a508-bcbd216aedf2",
      "area_code": "248",
      "phone_type": "voice",
      "provider": "teli-voice",
      "user_id": "e4de5844-5b7b-45bb-8717-2c6f1f3f52ca",
      "organization_id": "4d051118-c116-4923-8ff4-1a9761115fec",
      "tenant_id": "your_tenant",
      "outbound_agent_id": null,
      "inbound_agent_id": null,
      "created_at": "2025-11-20T19:16:27.594576"
    }
  ],
  "powered_by": "Teli"
}
500 (Server Error)
{
  "error": "Failed to list phone numbers",
  "success": false,
  "powered_by": "Teli"
}

​
Ownership Model

  • User-Level: Phone numbers are owned by individual users
  • Admin View: Admin users can see all phone numbers in their organization
  • Regular Users: See only their own phone numbers

​
Agent Linking

  • outbound_agent_id: Agent used for outbound calls from this number
  • inbound_agent_id: Agent used for inbound calls to this number
  • Both are optional and can be set via POST /v1/voice/phone-numbers/{number}/update-agent

​
Notes

  • Phone numbers are provisioned through Teli Voice
  • Numbers can be linked to voice agents for automated calling
  • Admin users see all org numbers regardless of owner
  • E.164 format required: +[country code][number]