> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dncscrub.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 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

<ParamField body="loginId" type="string">
  API key. Only required if not provided via the `x-dncscrub-api-key` HTTP header.
</ParamField>

## Response

<ResponseField name="success" type="boolean">
  Whether the API call succeeded.
</ResponseField>

<ResponseField name="states" type="array">
  List of all states with their emergency status.

  <Expandable title="state object">
    <ResponseField name="state" type="string">
      2-letter state code.
    </ResponseField>

    <ResponseField name="isInEmergency" type="boolean">
      `true` if state has active emergency restrictions.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="emergencyStates" type="string[]">
  List of state codes currently under emergency restrictions.
</ResponseField>

<ResponseField name="hasActiveEmergencies" type="boolean">
  `true` if any state has active emergency restrictions.
</ResponseField>

<ResponseField name="errorCode" type="string">
  Machine-readable error code (when failed).
</ResponseField>

<ResponseField name="errorMessage" type="string">
  Human-readable error description (when failed).
</ResponseField>

## Examples

<Tabs>
  <Tab title="Request">
    ```json theme={null}
    {}
    ```
  </Tab>

  <Tab title="No Emergencies">
    ```json theme={null}
    {
      "success": true,
      "states": [
        { "state": "CA", "isInEmergency": false },
        { "state": "FL", "isInEmergency": false },
        { "state": "TX", "isInEmergency": false }
      ],
      "emergencyStates": [],
      "hasActiveEmergencies": false
    }
    ```
  </Tab>

  <Tab title="Active Emergency">
    ```json theme={null}
    {
      "success": true,
      "states": [
        { "state": "CA", "isInEmergency": false },
        { "state": "FL", "isInEmergency": true },
        { "state": "TX", "isInEmergency": false }
      ],
      "emergencyStates": ["FL"],
      "hasActiveEmergencies": true
    }
    ```
  </Tab>
</Tabs>

## 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