The company DNC (do not call) list lets you block direct, manual outbound calls as well as outbound and scheduled calls created by the Apps API.
CCAI Platform Apps API provides the following three endpoints for DNC:
Add phone numbers to the DNC list
Parameter | Required | Data Type | Definition |
---|---|---|---|
contacts | TRUE | Array contacts | An array of contacts. Each contact has a `phone_number` attribute and optional `expires_at` attribute |
Endpoint:
Method: POST
Type: RAW
URL: https://{subdomain}.{domain}/apps/api/v1/outbound_dialer/dnc
Headers:
Key | Value | Description |
---|---|---|
Content-Type | application/json |
Body:
{
"contacts": [
{
"phone_number": "+1-7187309219",
"expires_at": "2022-10-29 00:00:00 UTC"
},
{
"phone_number": "+1-(358)-213-1634"
}
]
}
Example request and responses
The following sections provide example requests to the endpoint.
Add some contacts to the DNC list
This example shows the adding of contacts to the DNC list.
Request
Headers:
Key | Value | Description |
---|---|---|
Content-Type | application/json |
Body:
{
"contacts": [
{
"phone_number": "+1-7187309219",
"expires_at": "2022-10-29 00:00:00 UTC"
},
{
"phone_number": "+1-(358)-213-1634"
},
{
"phone_number": "+1-4151113333",
"expires_at": "2022-10-30 00:00:00 UTC"
},
{
"phone_number": "+1-4151115555"
},
{
"phone_number": "+1-7187309219",
"expires_at": "2022-10-27 00:00:00 UTC"
},
{
"phone_number": "sssssss"
},
{
"phone_number": "911",
"expires_at": "2023-02-05 00:00:00 UTC"
}
]
}
Response
[
{
"phone_number": "+1-7187309219",
"expires_at": "2022-10-29 00:00:00 UTC",
"status": "created"
},
{
"phone_number": "+1-(358)-213-1634",
"status": "created"
},
{
"phone_number": "+1-4151113333",
"expires_at": "2022-10-30 00:00:00 UTC",
"status": "updated"
},
{
"phone_number": "+1-4151115555",
"status": "updated"
},
{
"phone_number": "+1-7187309219",
"expires_at": "2022-10-27 00:00:00 UTC",
"error": "expires_at cannot be past date/time",
"status": "failed"
},
{
"phone_number": "sssssss",
"error": "phone_number is invalid",
"status": "failed"
},
{
"phone_number": "911",
"expires_at": "2023-02-05 00:00:00 UTC",
"error": "emergency phone number is not allowed",
"status": "failed"
}
]
Code: 200
Remove numbers from the DNC list
Parameter | Required | Data Type | Definition |
---|---|---|---|
phone_numbers | TRUE | Array String | An array containing phone numbers that should be removed from the DNC list. |
Endpoint:
Method: POST
Type: RAW
URL: https://{subdomain}.{domain}/apps/api/v1/outbound_dialer/dnc/remove
Headers:
Key | Value | Description |
---|---|---|
Content-Type | application/json |
Body:
{
"phone_numbers": [
"1-415-111-1111"
]
}
Example request and responses
The following sections provide example requests to the endpoint.
Remove a list of phone numbers
This example shows how to remove phone numbers from the list.
Request
Headers:
Key | Value | Description |
---|---|---|
Content-Type | application/json |
Body:
{
"phone_numbers": [
"1-415-111-1111",
"1-415-222-2222",
"1-415-333-333-3333"
]
}
Response: Success
{}
Status Code: 200
Check whether a phone number is on the DNC list
Parameter | Required | Data Type | Definition |
---|---|---|---|
phone_number | TRUE | String | The phone number to check if it is in the DNC list |
Endpoint:
Method: GET
Type:
URL: URL: https://{subdomain}.{domain}/apps/api/v1/outbound_dialer/dnc/check?phone_number={phone_number}
Headers:
None
Body:
None
Example request and responses
The following sections provide example requests to the endpoint.
Check if number is in the DNC list
This example showes how to check if a phone number is in the DNC list.
Request
Key | Value |
---|---|
phone_number | {PHONE_NUMBER} (Number) The end-user's phone number. |
GET https://{subdomain}.{domain}/apps/api/v1/outbound_dialer/dnc/check?phone_number={PHONE_NUMBER}
Response
{
"phone_number": "1-415-111-1111",
"expired_at": "2023-08-05 22:02:36.362009 +0000"
"do_not_call": true
}
Code: 200