Blocklist and DNC

Two suppression lists on Edesy - the inbound blocklist that refuses calls from listed numbers, and the DNC list that stops campaigns calling listed numbers. Endpoints and fields.

2 min read

Edesy keeps two separate lists. The inbound blocklist (/v1/blocked-callers) refuses calls from listed numbers to any number in your workspace, before any routing runs. The DNC list (/v1/dnc) stops your campaigns calling to listed numbers. Adding a number to one list does not affect the other.

Inbound blocklist DNC list
Stops Calls from the number to you Your campaign calls to the number
Applies to Every inbound call in the workspace Campaign contacts and leads
Endpoint /v1/blocked-callers /v1/dnc

Inbound blocklist#

Method Path Description
GET /v1/blocked-callers List blocked callers
POST /v1/blocked-callers Block a caller
DELETE /v1/blocked-callers/{id} Unblock
curl -X POST https://voice-api.edesy.in/v1/blocked-callers \
  -H "Authorization: Bearer $EDESY_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "phone_number": "+9198XXXXXXXX", "note": "Repeated spam calls" }'
Field Type Required Description
phone_number string Required 4 to 20 characters. Numbers are normalised, so +91 98..., 098... and 98... match the same caller
note string Optional Up to 200 characters

Blocked calls are refused before they are answered, so there is no talk-time charge.

DNC list#

Method Path Description
GET /v1/dnc List entries
POST /v1/dnc Add numbers
DELETE /v1/dnc/{id} Remove an entry
curl -X POST https://voice-api.edesy.in/v1/dnc \
  -H "Authorization: Bearer $EDESY_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "phone_numbers": ["+9198XXXXXXXX", "+9197XXXXXXXX"], "reason": "opt_out", "source": "agent_disposition", "notes": "Asked not to be called" }'
Field Type Description
phone_numbers array Numbers to add
reason string opt_out, complaint, registry or manual
source, notes string Your own context
{ "data": { "added": 2, "already_present": 0, "invalid": 0, "invalid_samples": [] } }

Entries marked global: true are platform-wide suppressions. You can see them but not remove them.

When contacts or leads are added to a campaign, DNC numbers are counted as suppressed_dnc and never dialed. See AMD, Fallback Caller ID and DNC.

Was this page helpful?