Find which phone numbers are on the do-not-call list

POST/calls/screen-do-not-call

Returns the subset of the submitted numbers that must not be called. Unlike /calls/phone-history, which only knows numbers the organization has already called, this screens any number, so a contact imported for the first time can be caught before the campaign is created.

Request

curl -X POST "https://www.getrevox.com/api/calls/screen-do-not-call" \
  -H "Authorization: Bearer $REVOX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "phone_numbers": ["+33612345678", "+33698765432"] }'

const res = await fetch("https://www.getrevox.com/api/calls/screen-do-not-call", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.REVOX_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    phone_numbers: [
      "+33612345678",
      "+33698765432",
    ],
  }),
});
const data = await res.json();
console.log(data);

import os

import requests

response = requests.post(
    "https://www.getrevox.com/api/calls/screen-do-not-call",
    headers={"Authorization": f"Bearer {os.environ['REVOX_API_KEY']}"},
    json={
        "phone_numbers": [
            "+33612345678",
            "+33698765432",
        ],
    },
    timeout=30,
)
response.raise_for_status()
print(response.json())

Try itSend this request live

Response

Success

{ "blocked": ["+33612345678"] }

Request body

application/json

phone_numbersarray of stringrequired
The phone numbers to screen, up to 20,000. International (E.164) format; a number that cannot be parsed is ignored.
at most 20000 items

Response

200

blockedarray of string
The submitted numbers on the do-not-call list, in E.164 format. Empty when none is.