Skip to main content
GET
/
v1
/
contacts
/
lists
/
{id}
/
contacts
curl -X GET "https://api.teli.ai/v1/contacts/lists/{list_id}/contacts?user_id={user_id}&is_admin=true" \
  -H "X-API-Key: YOUR_API_KEY"

{
  "success": true,
  "total": 25,
  "contacts": [
    {
      "lead_id": "1763072372569x...",
      "unique_id": "1763072372569x...",
      "phone_number": "+15551234567",
      "first_name": "John",
      "last_name": "Doe",
      "email": "john@example.com"
    }
  ],
  "powered_by": "Teli"
}

​
Authorizations

​
X-API-Key
string
required
Authentication header

​
Path

​
id
string
required
Contact list unique_id

​
Query Parameters

​
user_id
string
User unique_id (for access control)
​
is_admin
boolean
If true, admin can view any list in the org. If false/missing, user can only view their own lists.
curl -X GET "https://api.teli.ai/v1/contacts/lists/{list_id}/contacts?user_id={user_id}&is_admin=true" \
  -H "X-API-Key: YOUR_API_KEY"

{
  "success": true,
  "total": 25,
  "contacts": [
    {
      "lead_id": "1763072372569x...",
      "unique_id": "1763072372569x...",
      "phone_number": "+15551234567",
      "first_name": "John",
      "last_name": "Doe",
      "email": "john@example.com"
    }
  ],
  "powered_by": "Teli"
}