List black lists
/v1/accounts/{accountId}/blackListsReturns the black 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.
Black lists with any of the given IDs.
{"ids":["BLACK_LIST_ID_1","BLACK_LIST_ID_2"]}Black lists whose name contains the text (case-insensitive).
{"name":"do not call"}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 black 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: blackLists 0-9/57. See Pagination.
/v1/accounts/ACCOUNT_ID/blackLists
curl -G 'https://api.sipcaller.com/v1/accounts/ACCOUNT_ID/blackLists' \
-H 'Authorization: Bearer API_KEY_TOKEN' \
--data-urlencode 'filter={"name":"call"}' \
--data-urlencode 'sort=["name","ASC"]' \
--data-urlencode 'range=[0,99]'Response
200 OK
[
{
"id": "01a0dedd-b9a2-729d-8e0a-4e3ad9197aea",
"name": "Do Not Call",
"numbersCount": 3,
"updatedAt": "2026-09-26T17:57:48.064"
},
{
"id": "01a0dad2-c0a6-7205-8d4e-a2d5f4197825",
"name": "National DNC Registry",
"numbersCount": 18452,
"updatedAt": "2026-09-25T23:09:37.921"
}
]
