search_compliance_guide Tool - Contact Center Compliance

The search_compliance_guide tool performs a retrieval-augmented (RAG) search over DNCScrub’s Compliance Guide — the authoritative source for federal and state telemarketing, TCPA, and Do Not Call regulatory guidance — and returns the most relevant content chunks with citations. Use it to ground compliance answers in source material before responding. Do not answer regulatory questions from memory alone; search the guide first to ensure accuracy.

When to Use

Answering questions about DNC rules, TCPA requirements, or state-specific calling restrictions
Looking up call-time windows, holiday restrictions, or registration requirements
Researching EBR (Established Business Relationship), consent rules, or penalties
Grounding an AI agent’s compliance decisions in DNCScrub’s authoritative guidance

For checking whether a specific phone number can legally be called, use scrub_phone_numbers instead. This tool returns regulatory guidance, not a per-number compliance result.

Parameters

query

string

required

Natural-language question to search the Compliance Guide for, e.g. “What are the call time restrictions in Florida?”

state

string

Optional 2-letter state/jurisdiction code to focus the search (e.g. CA), or a federal authority (FCC or FTC).

topic

string

Optional compliance topic to focus the search (e.g. Do Not Call, Call Times, EBR).

channel

string

Optional outreach channel to focus the search on. One of call, sms, or email.

topN

number

Maximum number of ranked chunks to return (1-25, default 10).

API key. Only required if not provided via the x-dncscrub-api-key HTTP header.

Response

success

boolean

Whether the search succeeded.

results

array

Ranked content chunks, most relevant first.

Show result object

text

string

Relevant excerpt of Compliance Guide content.

source

string

Human-readable name of the source document.

sourceUrl

string

Deep link into the Compliance Guide for citation.

state

string

State/jurisdiction the chunk pertains to, or null if not state-specific.

topic

string

Compliance topic the chunk pertains to, or null.

lastUpdated

string

Date the source was last updated (yyyy-MM-dd), or null if unavailable.

relevanceScore

number

Semantic relevance score (higher is more relevant).

chunkId

string

Stable identifier of the chunk within the search index.

resultCount

number

Number of chunks returned.

searchTimeMs

number

Time the search took, in milliseconds.

errorCode

string

Machine-readable error code (when failed): MISSING_INPUT, MISSING_API_KEY, INVALID_API_KEY, or API_ERROR.

errorMessage

string

Human-readable error description (when failed).

Examples

Request
Response

{
  "query": "What are the call time restrictions in Florida?",
  "state": "FL",
  "topic": "Call Times",
  "topN": 3
}

{
  "success": true,
  "results": [
    {
      "text": "Florida prohibits telephone solicitation calls before 8:00 AM or after 8:00 PM local time...",
      "source": "Call Times Summaries",
      "sourceUrl": "https://app.dncscrub.com/compliance-guide/regulatory-guide/call-times/FL",
      "state": "FL",
      "topic": "Call Times",
      "lastUpdated": "2026-01-01",
      "relevanceScore": 3.42,
      "chunkId": "call-times-fl-0"
    }
  ],
  "resultCount": 1,
  "searchTimeMs": 88
}

Usage Notes

Access requires a DNCScrub API key with Compliance Guide entitlement, the same authorization used by the other Compliance Guide tools.
state, topic, and channel focus the search. They bias ranking toward the most relevant guidance.
Always cite the returned sourceUrl when relaying guidance to an end user.
Results are excerpts of authoritative guidance; treat them as the most accurate source and prefer them over model priors.

​When to Use

​Parameters

​Response

​Examples

​Usage Notes

When to Use

Parameters

Response

Examples

Usage Notes