Retrieve a black list

GET/v1/accounts/{accountId}/blackLists/{blackListId}

Returns a black list.

accountIduuidRequired

ID of your SIP Caller account. See Account ID.

blackListIduuidRequired

ID of the black list.

Returns the black list object. If the black list doesn't exist, returns 404 Not Found.

GET

/v1/accounts/ACCOUNT_ID/blackLists/BLACK_LIST_ID

curl -G 'https://api.sipcaller.com/v1/accounts/ACCOUNT_ID/blackLists/BLACK_LIST_ID' \
  -H 'Authorization: Bearer API_KEY_TOKEN'

Response

200 OK

{
  "id": "01a0dedd-b9a2-729d-8e0a-4e3ad9197aea",
  "name": "Do Not Call",
  "numbersCount": 3,
  "updatedAt": "2026-09-26T17:57:48.064"
}

List black lists

Create a black list