Get Contact List
Returns detailed information about a specific contact list.
Endpoint
GET
v5/contactlist/{list_id}
Requires authentication
Path Parameters
The contact list to retrieve.
list_id
string
required
The ID of the contact list to retrieve.
Query Parameters
This endpoint does not accept additional query parameters beyond authentication credentials.
None
Response
Returns a single contact list object.
result_ok
boolean
Whether the request succeeded.
data
object
The contact list object.
child attributes
id
integer
The unique ID of the contact list.
list_name
string
The display name of the contact list.
date_modified
string
Timestamp when the contact list was last modified.
date_created
string
Timestamp when the contact list was created.
user_id_created
integer
The ID of the user who created the contact list.
user_id_modified
integer | null
The ID of the user who last modified the contact list, or
null if unmodified since creation.Examples
Note GET requests are cached for 60 seconds. Repeated identical requests within that window will return cached results.
Request (cURL)
curl -X GET "https://api.alchemer.com/v5/contactlist/YOUR_LIST_ID?api_token=YOUR_API_TOKEN&api_token_secret=YOUR_API_TOKEN_SECRET"
Response
{
"result_ok": true,
"data": {
"id": 100139484,
"list_name": "My New List",
"date_modified": "2015-08-04 17:06:59",
"date_created": "2015-08-04 16:00:00",
"user_id_created": 123456,
"user_id_modified": null
}
}