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

# Blacklist Alliance

> Validate phone numbers against the Blacklist Alliance database

### Description

Validate phone numbers against the Blacklist Alliance database. Use this integration to check numbers against DNC lists, perform bulk lookups, evaluate NEE complaints, and view API stats.

### Authentication

* Blacklist Alliance API Key.

### Available Actions

* Lookup single phone number
* Bulk lookup (up to \~1MB payload)
* NEE single (evaluate complaints)
* NEE group (evaluate group of numbers)
* API stats

### Examples

**Example 1: Blacklist Alliance - Lookup Single**

Lookup a single phone number against Blacklist Alliance.

```json theme={null}
{
  "automationType": "blacklist_alliance",
  "nodeId": "bla-lookup-001",
  "nodeParams": {
    "action": "lookup_single",
    "params": {
      "phone": "+17022918207",
      "apiKey": "YOUR_BLACKLIST_ALLIANCE_API_KEY",
      "ver": "1",
      "resp": "json"
    }
  }
}
```

**Example 2: Blacklist Alliance - Bulk Lookup**

Lookup a list of phone numbers (max \~1MB payload).

```json theme={null}
{
  "automationType": "blacklist_alliance",
  "nodeId": "bla-bulk-lookup-001",
  "nodeParams": {
    "action": "bulk_lookup",
    "params": {
      "apiKey": "YOUR_BLACKLIST_ALLIANCE_API_KEY",
      "phones": ["2223334444", "9999999999"]
    }
  }
}
```

**Example 3: Blacklist Alliance - NEE Single**

Evaluate a number for complaints (NEE GET).

```json theme={null}
{
  "automationType": "blacklist_alliance",
  "nodeId": "bla-nee-single-001",
  "nodeParams": {
    "action": "nee_single",
    "params": {
      "apiKey": "YOUR_BLACKLIST_ALLIANCE_API_KEY",
      "phone": "2223334444"
    }
  }
}
```

**Example 4: Blacklist Alliance - NEE Group**

Evaluate a group of numbers for complaints (NEE POST).

```json theme={null}
{
  "automationType": "blacklist_alliance",
  "nodeId": "bla-nee-group-001",
  "nodeParams": {
    "action": "nee_group",
    "params": {
      "apiKey": "YOUR_BLACKLIST_ALLIANCE_API_KEY",
      "phones": ["2223334444", "9999999999"]
    }
  }
}
```

**Example 5: Blacklist Alliance - API Stats**

Get API stats for the provided API key.

```json theme={null}
{
  "automationType": "blacklist_alliance",
  "nodeId": "bla-apistats-001",
  "nodeParams": {
    "action": "api_stats",
    "params": {
      "apiKey": "YOUR_BLACKLIST_ALLIANCE_API_KEY"
    }
  }
}
```

### Third-Party Documentation

* [https://www.blacklistalliance.com/](https://www.blacklistalliance.com/)