List black list numbers
/v1/accounts/{accountId}/blackLists/{blackListId}/numbersReturns the numbers of a black list, optionally filtered and sorted.
Path parameters
ID of your SIP Caller account. See Account ID.
ID of the black list.
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 ["number","DESC"]. Defaults to ["number","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.
Numbers that contain the text, which allows partial lookups.
{"number":"555010"}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 number in ascending order.
numberidReturns
Returns an array of black list number 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: blackListNumbers 0-9/57. See Pagination.
/v1/accounts/ACCOUNT_ID/blackLists/BLACK_LIST_ID/numbers
curl -G 'https://api.sipcaller.com/v1/accounts/ACCOUNT_ID/blackLists/BLACK_LIST_ID/numbers' \
-H 'Authorization: Bearer API_KEY_TOKEN' \
--data-urlencode 'filter={"number":"555010"}' \
--data-urlencode 'sort=["number","DESC"]' \
--data-urlencode 'range=[0,99]'Response
200 OK
[
{
"id": 3,
"number": "+18005550103",
"description": "Asked not to be called again"
},
{
"id": 2,
"number": "+18005550102",
"description": null
},
{
"id": 1,
"number": "+18005550101",
"description": "Customer request, 2026-09-12"
}
]
