{
"id": 42,
"phone_number": "+12025551234",
"brand_name": "Acme Co",
"list_name": "Acme Promo List",
"list_type": "twilio",
"status": "active",
"contact_count": 15230,
"created_at": "2025-03-15T14:30:00"
}
{
"error": "List not found",
"code": "not_found"
}
{
"error": "Invalid credentials",
"code": "invalid_credentials"
}
Lists (v2)
Get a Sending List
Retrieve a single sending list by its ID.
GET
/
v2
/
lists
/
{list_id}
{
"id": 42,
"phone_number": "+12025551234",
"brand_name": "Acme Co",
"list_name": "Acme Promo List",
"list_type": "twilio",
"status": "active",
"contact_count": 15230,
"created_at": "2025-03-15T14:30:00"
}
{
"error": "List not found",
"code": "not_found"
}
{
"error": "Invalid credentials",
"code": "invalid_credentials"
}
Returns the full details of a single sending list, including a current count of subscribed contacts.
Path Parameters
Response Fields
Examples
cURL
curl -X GET "https://api.tracklysms.com/api/v2/lists/42" \
-H "X-Api-Key: trk_your_api_key_here"
Python
import requests
response = requests.get(
"https://api.tracklysms.com/api/v2/lists/42",
headers={"X-Api-Key": "trk_your_api_key_here"}
)
data = response.json()
print(f"{data['list_name']} — {data['contact_count']} contacts")
Node.js
const response = await fetch(
"https://api.tracklysms.com/api/v2/lists/42",
{
headers: {
"X-Api-Key": "trk_your_api_key_here",
},
}
);
const data = await response.json();
console.log(data);
{
"id": 42,
"phone_number": "+12025551234",
"brand_name": "Acme Co",
"list_name": "Acme Promo List",
"list_type": "twilio",
"status": "active",
"contact_count": 15230,
"created_at": "2025-03-15T14:30:00"
}
{
"error": "List not found",
"code": "not_found"
}
{
"error": "Invalid credentials",
"code": "invalid_credentials"
}
Error Codes
| HTTP Status | Error Code | Description |
|---|---|---|
| 401 | invalid_credentials | API key is missing or invalid. |
| 403 | account_suspended | Your account is suspended. Resolve outstanding billing or contact support. |
| 404 | not_found | No sending list exists with the given ID, or the list has been deleted. |
Next Steps
Contacts Overview
Manage contacts across your lists
List Contacts
View contacts on a specific list