Retrieve a contact list
GET
/v1/accounts/{accountId}/contactLists/{contactListId}Returns a contact list.
Path parameters
accountIduuidRequired
ID of your SIP Caller account. See Account ID.
contactListIduuidRequired
ID of the contact list.
Returns
Returns the contact list object. If the contact list doesn't exist, returns 404 Not Found.
GET
/v1/accounts/ACCOUNT_ID/contactLists/CONTACT_LIST_ID
cURL
curl -G 'https://api.sipcaller.com/v1/accounts/ACCOUNT_ID/contactLists/CONTACT_LIST_ID' \
-H 'Authorization: Bearer API_KEY_TOKEN'Response
200 OK
{
"id": "019ffc4b-1c59-72ed-b15a-cbf81a2b95d9",
"name": "Overdue Accounts",
"numbersCount": 1255,
"varNames": [
"Customer Name",
"Due Balance"
],
"updatedAt": "2026-08-13T18:03:28.729"
}
