Skip to main content
GET
List DNC entries (or look up by phone)
Returns every Do-Not-Call entry for your company, ordered by most-recently added. Phone numbers are stored in E.164. Use this to render a DNC management UI or to back-fill an external suppression list. Pass ?phone=... to look up a single entry instead of listing all. The number is normalized before lookup, so +972501234567, 972501234567, and 0501234567 all resolve to the same row. Required scope: do_not_call:read.

Example request

Example response

When ?phone=... is supplied the response is the single entry object directly (not wrapped in data).

Errors

Authorizations

Authorization
string
header
required

Your Yappr API key (e.g. ypr_live_...). Generate one in the dashboard under Settings → API Keys.

Query Parameters

phone
string

Single-number lookup. Returns 404 if the number is not on the list.

Response

List of DNC entries (or one entry when phone is supplied)

data
object[]