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, each with a source name and a link to the Compliance Guide. 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?” Include any state, topic, or channel directly in the query text — the search is semantic.

topN

number

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

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

Link into the Compliance Guide for citation.

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?",
  "topN": 3
}

{
  "success": true,
  "results": [
    {
      "text": "Florida prohibits telephone solicitation calls before 8:00 AM or after 8:00 PM local time...",
      "source": "Time Restriction",
      "sourceUrl": "https://www.dncscrub.com/compliance-guide/regulatory-guide",
      "relevanceScore": 3.42,
      "chunkId": "call-times-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.
The search is semantic — put any state, topic, or channel directly in the query text (e.g. “SMS call-time restrictions in Florida”) rather than as separate parameters.
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