Skip to main content
GET
/
v1
/
sms
/
phone-numbers
/
config
SMS Phone Config
curl --request GET \
  --url https://api.example.com/v1/sms/phone-numbers/config \
  --header 'X-API-Key: <x-api-key>'
{
  "success": true,
  "enabled": true,
  "max_per_org": 123,
  "weekly_price": 123
}

​
SMS Phone Number Configuration

Retrieve the tenant’s multi-SMS phone number configuration, including whether the feature is enabled, the maximum number of SMS numbers allowed per organization, and pricing.

​
Authentication

​
X-API-Key
string
required
Your API key

​
Response

​
success
boolean
Whether the request was successful
​
enabled
boolean
Whether multi-SMS numbers per organization is enabled for this tenant. If false, the standard single SMS number per organization applies.
​
max_per_org
integer
Maximum number of SMS phone numbers allowed per organization
​
weekly_price
number
Weekly price per phone number (in USD)

​
Example Request

curl -X GET "https://api.teli.ai/v1/sms/phone-numbers/config" \
  -H "X-API-Key: your-api-key"

​
Example Response (Feature Enabled)

{
  "success": true,
  "enabled": true,
  "max_per_org": 10,
  "weekly_price": 1.50,
  "powered_by": "Teli"
}

​
Example Response (Feature Not Enabled)

{
  "success": true,
  "enabled": false,
  "max_per_org": 0,
  "weekly_price": 0,
  "powered_by": "Teli"
}

​
Use Cases

  • Check if multi-SMS is available before showing the SMS Phones UI
  • Display pricing information to users
  • Validate whether an organization can purchase more numbers

​
Notes

  • This is a tenant-level configuration, not per-organization
  • Contact support to enable multi-SMS for your tenant
  • The standard configuration (when not enabled) is one SMS number per organization, managed through 10DLC registration