Download black list numbers
/v1/accounts/{accountId}/blackLists/{blackListId}/numbers/downloadDownloads the numbers of a black list as a CSV (comma-separated values) file. The file includes all the records matching the filter, without pagination. It accepts the same filter and sort parameters as List black list numbers, whose Filter fields and Sort fields sections list the fields that can be used.
Path parameters
ID of your SIP Caller account. See Account ID.
ID of the black list.
Query parameters
Returns
Returns the CSV file, with a header row, as text/plain; charset=utf-8. The columns are Number and Description. The Content-Disposition header contains a suggested file name. The file is generated while it's being sent, so if an error occurs halfway, the content ends with the line === RESPONSE ABORTED: INTERNAL SERVER ERROR === and must be discarded.
/v1/accounts/ACCOUNT_ID/blackLists/BLACK_LIST_ID/numbers/download
curl -G 'https://api.sipcaller.com/v1/accounts/ACCOUNT_ID/blackLists/BLACK_LIST_ID/numbers/download' \
-H 'Authorization: Bearer API_KEY_TOKEN' \
--data-urlencode 'sort=["number","ASC"]' \
-o 'black-list-numbers.csv'Response
200 OK
Number,Description
+18005550101,"Customer request, 2026-09-12"
+18005550102,
+18005550103,Asked not to be called again
