---
canonical_url: "https://docs.composio.dev/toolkits/debounce"
markdown_url: "https://docs.composio.dev/toolkits/debounce.md"
product: "platform"
version: null
last_updated: null
---

# DeBounce

DeBounce validates email addresses, enriches contact data, reports account usage, and processes bulk email-validation lists.

- **Category:** email
- **Auth:** API_KEY
- **Composio-managed OAuth available?** N/A
- **Tools:** 4
- **Triggers:** 0
- **Slug:** `DEBOUNCE`
- **Version:** 00000000_00

## Tools

### Get Account Balance

**Slug:** `DEBOUNCE_GET_ACCOUNT_BALANCE`

Return the connected DeBounce account's remaining validation-credit balance.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get API Usage

**Slug:** `DEBOUNCE_GET_API_USAGE`

Return the aggregate number of DeBounce API validation calls in an inclusive date range.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `end_date` | string | Yes | Inclusive end date in YY-MM-DD format. It must be on or after start_date and no later than today. |
| `start_date` | string | Yes | Inclusive start date in YY-MM-DD format. The earliest allowed date is 20-08-14. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Bulk Validation Status

**Slug:** `DEBOUNCE_GET_BULK_VALIDATION_STATUS`

Check progress for a bulk validation list created through the DeBounce Bulk API and return its result download URL when available.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `list_id` | string | Yes | List identifier returned by a DeBounce Bulk API upload. Lists uploaded through the dashboard are not supported. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Validate Email

**Slug:** `DEBOUNCE_VALIDATE_EMAIL`

Validate one email address with DeBounce and return its deliverability result, reason, and remaining credit balance. Basic validation consumes 1 credit. Profile-photo lookup can cost 1 additional credit and contact enrichment can cost 20 additional credits; both are disabled unless explicitly enabled.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Email address to validate. Invalid syntax is intentionally accepted so DeBounce can return its Syntax classification. |
| `include_photo` | boolean | No | Request a profile photo when available. Enable only when needed; a successful photo lookup costs 1 additional credit. This option is documented but was not independently live-probed. |
| `detect_gsuite_accept_all` | boolean | No | Request G Suite accept-all detection. No separate extra-credit charge is documented. This option is documented but was not independently live-probed. |
| `include_contact_enrichment` | boolean | No | Request enriched contact details such as full name and avatar. Enable explicitly because successful enrichment costs 20 additional credits. This option is documented but was not independently live-probed. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |