List contact lists
/v1/accounts/{accountId}/contactListsReturns the contact lists of the account, optionally filtered and sorted.
Path parameters
ID of your SIP Caller account. See Account ID.
Query parameters
Conditions that the records must match, such as {"name":"sales"}. See the Filter fields below, and Filter for the syntax.
Field and direction used to sort the records, such as ["name","DESC"]. Defaults to ["name","ASC"]. See Sort.
Zero-based positions of the first and last records to return, both included, such as [0,99]. Defaults to [0,9]. See Pagination.
Filter fields
Fields that can be used in the filter query parameter. See Filter for the general syntax.
Contact lists with any of the given IDs.
{"ids":["CONTACT_LIST_ID_1","CONTACT_LIST_ID_2"]}Contact lists whose name contains the text (case-insensitive).
{"name":"overdue"}Sort fields
Fields that can be used in the sort query parameter, in ascending (ASC) or descending (DESC) order. See Sort for the general syntax. When sort is omitted, results are sorted by name in ascending order.
namenumbersCountReturns
Returns an array of contact list objects for the requested page. The X-Total-Count and Content-Range headers contain the total number of records matching the filter, for example Content-Range: contactLists 0-9/57. See Pagination.
/v1/accounts/ACCOUNT_ID/contactLists
curl -G 'https://api.sipcaller.com/v1/accounts/ACCOUNT_ID/contactLists' \
-H 'Authorization: Bearer API_KEY_TOKEN' \
--data-urlencode 'filter={"name":"overdue"}' \
--data-urlencode 'sort=["name","ASC"]' \
--data-urlencode 'range=[0,99]'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"
}
]
