Skip to main content
POST
/
v1
/
10dlc
/
phone-numbers
/
purchase
curl -X POST https://api.teli.ai/v1/10dlc/phone-numbers/purchase \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phoneNumbers": ["3135559999"],
    "groupId": "YOUR_GROUP_ID",
    "tollFree": false,
    "mock": true
  }'

{
  "message": "Successfully purchased phone number",
  "sid": ["47178d4c-6d1d-4cf9-a0aa-djfseifni"],
  "response": [
    {
      "sid": "47178d4c-6d1d-4cf9-a0aa-djfseifni",
      "phoneNumber": "13135559999",
      "status": "success"
    }
  ],
  "powered_by": "Teli"
}
Purchase one or more phone numbers for your SMS campaigns.
Phone numbers must be purchased before creating campaigns. Each number can be used for one campaign.

​
Authorizations

​
X-API-Key
string
required
Authentication header

​
Body

​
phoneNumbers
array
required
Array of phone numbers to purchase (without country code, 10 digits only).Example: ["3135551234", "3135555678"]
Numbers must be available. Purchase may fail if already taken.
​
groupId
string
required
Your account group ID
​
subGroupId
string
Optional subgroup ID to assign numbers to
​
tollFree
boolean
Set to true for toll-free numbers (800, 888, etc.)Default: false (10DLC local numbers)
​
mock
boolean
Set to true for testing (no real purchase)Default: false
curl -X POST https://api.teli.ai/v1/10dlc/phone-numbers/purchase \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phoneNumbers": ["3135559999"],
    "groupId": "YOUR_GROUP_ID",
    "tollFree": false,
    "mock": true
  }'

{
  "message": "Successfully purchased phone number",
  "sid": ["47178d4c-6d1d-4cf9-a0aa-djfseifni"],
  "response": [
    {
      "sid": "47178d4c-6d1d-4cf9-a0aa-djfseifni",
      "phoneNumber": "13135559999",
      "status": "success"
    }
  ],
  "powered_by": "Teli"
}

​
Response

​
response
array
Array of purchase results, one per requested number
​
response[].phoneNumber
string
Phone number (11 digits with country code)
​
response[].status
string
success or failed
​
response[].sid
string
System identifier (if successful)

​
Tips

  • Area Code: Choose numbers in your business’s area code for better trust
  • Multiple Numbers: You can purchase multiple numbers in one request
  • Availability: Popular area codes may have limited availability
  • Mock Mode: Test with mock: true before real purchases