curl "https://api.telzino.com/v1/suppression-check?to_number=%2B15105550123&organization_id=234cd323-…" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
{
"data": {
"to_number": "+15105550123",
"organization_id": "234cd323-…",
"suppressed": true,
"scopes": ["reseller", "partner"]
}
}
Suppression List
Check a Number
Which suppression lists block a number for an organization’s calls
GET
/
v1
/
suppression-check
curl "https://api.telzino.com/v1/suppression-check?to_number=%2B15105550123&organization_id=234cd323-…" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
{
"data": {
"to_number": "+15105550123",
"organization_id": "234cd323-…",
"suppressed": true,
"scopes": ["reseller", "partner"]
}
}
Returns every list that holds the number for calls placed by an organization: its own list, its reseller’s and its partner’s. This is the same check an outbound call runs before it is placed. Use it to find out why a call was refused with
409 suppressed.
An account key can check any organization in the account. A reseller key can check organizations under its reseller. An organization key can check only its own organization.
Query Parameters
The E.164 number, e.g.
+15105550123. Percent-encode the + (%2B15105550123); an unencoded + is recovered too.Response
Every list holding the number, most specific first:
organization, reseller, partner. Empty when the number is not suppressed. The first entry is the suppression_scope a refused trigger reports.curl "https://api.telzino.com/v1/suppression-check?to_number=%2B15105550123&organization_id=234cd323-…" \
-H "Authorization: Bearer YOUR_ACCESS_TOKEN"
{
"data": {
"to_number": "+15105550123",
"organization_id": "234cd323-…",
"suppressed": true,
"scopes": ["reseller", "partner"]
}
}
| Code | Meaning |
|---|---|
200 | Checked |
400 | organization_id is missing, or to_number is not E.164 |
404 | Organization not found or access denied |
500 | The lists could not be read |
