Skip to main content
The get_state_holidays tool returns all states and their restricted holidays where telemarketing calls are prohibited. Use this to plan campaigns and avoid calling on state holidays.

When to Use

  • Planning campaign schedules around state holidays
  • Building holiday-aware calling calendars
  • Compliance auditing and reporting

Parameters

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

Response

success
boolean
Whether the API call succeeded.
holidays
array
List of all state holidays with calling restrictions.
stateCount
number
Number of unique states with restricted holidays.
holidayCount
number
Total number of restricted holidays.
errorCode
string
Machine-readable error code (when failed).
errorMessage
string
Human-readable error description (when failed).

Examples

{}

Usage Notes

  • Different states have different restricted holidays
  • Some holidays are state-specific (e.g., Texas Independence Day)
  • Federal holidays may not be restricted in all states
  • Use this data to build state-aware calling calendars
  • For real-time holiday checking, is_time_legal_to_call automatically accounts for holidays