Check DNC status for a phone number
Returns whether the given E.164 phone number appears on any of the platform’s Do-Not-Call sources (tenant contacts.dnc, tenant dnc_list, platform-wide DNC, explicit consent opt-out). Read-only — does not perform a send. Use this before any outbound SMS / Voice initiation to pre-flight the compliance check that the actual send path enforces.
Gated behind organizations.settings.dnc_sync_enabled (audit #SCAN-CMP-005). Federal/state/TCR feed ingestion is currently a stub; tenants must explicitly opt in (acknowledging the gap) before the endpoint is served. When the flag is OFF, responses are HTTP 403 with code DNC_SYNC_NOT_ENABLED. When ON, responses include federal_feeds_synced: false until real FTC/state/TCR sync lands.
Authorizations
Dashboard JWT token from Clerk
Query Parameters
E.164 phone number to check (e.g. +14155551234).
Optional ISO 3166-1 alpha-2 country code. Reserved for future country-specific lookups; currently informational.
Response
Default Response