Skip to main content
GET
/
v1
/
sms
/
phone-numbers
/
my-number
Get My SMS Number
curl --request GET \
  --url https://api.example.com/v1/sms/phone-numbers/my-number \
  --header 'X-API-Key: <x-api-key>'
{
  "success": true,
  "phone_number": "<string>",
  "has_number": true
}
Multi-SMS Feature: This endpoint is only applicable for tenants with multiple SMS numbers per organization enabled.

​
Get My SMS Number

Retrieve the SMS phone number assigned to a specific user. Returns the number if one is assigned, or indicates that no number is currently assigned.

​
Authentication

​
X-API-Key
string
required
Your API key

​
Query Parameters

​
user_id
string
required
The user’s unique_id
​
organization_id
string
required
The organization’s unique_id

​
Response

​
success
boolean
Whether the request was successful
​
phone_number
string
The user’s assigned SMS phone number in E.164 format, or null if none assigned
​
has_number
boolean
true if the user has an assigned number, false otherwise

​
Example Request

curl -X GET "https://api.teli.ai/v1/sms/phone-numbers/my-number?user_id=user_xyz789&organization_id=org_abc123" \
  -H "X-API-Key: your-api-key"

​
Example Response (Number Assigned)

{
  "success": true,
  "phone_number": "+14155551234",
  "has_number": true,
  "powered_by": "Teli"
}

​
Example Response (No Number Assigned)

{
  "success": true,
  "phone_number": null,
  "has_number": false,
  "powered_by": "Teli"
}

​
Error Responses

400
{
  "success": false,
  "error": "user_id and organization_id query parameters required"
}

​
Use Cases

  • Check if a user has an SMS number before creating a campaign
  • Display the user’s assigned number in the dashboard
  • Determine if a user needs to be assigned a number by an admin