Skip to main content
GET
/
v1
/
10dlc
/
phone-numbers
/
search
Search Phone Numbers
curl --request GET \
  --url https://api.example.com/v1/10dlc/phone-numbers/search \
  --header 'X-API-Key: <x-api-key>'
{
  "success": true,
  "phone_numbers": [
    {
      "phone_number": "<string>",
      "friendly_name": "<string>",
      "city": "<string>",
      "state": "<string>",
      "postal_code": "<string>",
      "capabilities": {}
    }
  ],
  "count": 123,
  "total_records": 123,
  "page": 123
}
Search for available 10DLC phone numbers by area code. Use this before purchasing to find numbers in your desired area.

​
Authentication

​
X-API-Key
string
required
Your API key

​
Query Parameters

​
areaCode
string
Area code to search (e.g., 313, 248). Required unless searching toll-free.
​
contains
string
Search for numbers containing this pattern (e.g., 555)
​
tollFree
boolean
default:"false"
Search for toll-free numbers instead of local numbers
​
page
string
default:"1"
Page number for pagination
​
limit
string
default:"20"
Number of results per page

​
Example Request

curl -X GET "https://api.teli.ai/v1/10dlc/phone-numbers/search?areaCode=313&limit=5" \
  -H "X-API-Key: YOUR_API_KEY"

​
Response

​
success
boolean
Whether the request was successful
​
phone_numbers
array
Array of available phone number objects
​
count
integer
Number of results returned
​
total_records
integer
Total available numbers matching the search
​
page
integer
Current page number

​
Example Response

200
{
  "success": true,
  "phone_numbers": [
    {
      "phone_number": "+13135551234",
      "friendly_name": "+1 313-555-1234",
      "city": "Detroit",
      "state": "MI",
      "postal_code": "48201",
      "capabilities": {
        "sms": true,
        "mms": true,
        "voice": true
      }
    },
    {
      "phone_number": "+13135555678",
      "friendly_name": "+1 313-555-5678",
      "city": "Detroit",
      "state": "MI",
      "postal_code": "48201",
      "capabilities": {
        "sms": true,
        "mms": true,
        "voice": true
      }
    }
  ],
  "count": 2,
  "total_records": 50,
  "page": 1,
  "powered_by": "Teli"
}

​
Notes

  • Phone numbers shown are available but not reserved. Purchase quickly to secure your number.
  • Use the phone_number value from the search results when calling the purchase endpoint.
  • All numbers returned are SMS-enabled.