get_state_emergencies Tool

Get states with emergency declarations restricting telephone solicitations

The get_state_emergencies tool returns all states currently under emergency declarations that restrict telephone solicitation calls. Some states prohibit or restrict telephone solicitations during declared emergencies such as natural disasters.

When to Use

• Checking for active emergencies before campaigns
• Real-time compliance monitoring
• Disaster response awareness for call centers

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.

states · array

List of all states with their emergency status.

Show state object

state · string

2-letter state code.

isInEmergency · boolean

true if state has active emergency restrictions.

emergencyStates · string[]

List of state codes currently under emergency restrictions.

hasActiveEmergencies · boolean

true if any state has active emergency restrictions.

errorCode · string

Machine-readable error code (when failed).

errorMessage · string

Human-readable error description (when failed).

Examples

Request

{}

No Emergencies

{
  "success": true,
  "states": [
    { "state": "CA", "isInEmergency": false },
    { "state": "FL", "isInEmergency": false },
    { "state": "TX", "isInEmergency": false }
  ],
  "emergencyStates": [],
  "hasActiveEmergencies": false
}

Active Emergency

{
  "success": true,
  "states": [
    { "state": "CA", "isInEmergency": false },
    { "state": "FL", "isInEmergency": true },
    { "state": "TX", "isInEmergency": false }
  ],
  "emergencyStates": ["FL"],
  "hasActiveEmergencies": true
}

Usage Notes

• Check regularly during disaster seasons (hurricane, wildfire, etc.)
• Emergency restrictions can be declared and lifted quickly
• Use emergencyStates array for quick filtering
• The hasActiveEmergencies flag provides a quick check if any restrictions exist
• For real-time compliance, is_time_legal_to_call automatically accounts for emergencies