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
}

Documentation Index

Fetch the complete documentation index at: https://docs.teli.ai/llms.txt

Use this file to discover all available pages before exploring further.

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.