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

# DeBounce API

> Technical overview of the DeBounce email validation API.

The DeBounce API enables accurate email validation, verification, and enrichment at scale.
It is built for developers who need reliable email quality checks inside applications, CRMs, signup flows, and automated workflows.

<CardGroup cols={2}>
  <Card title="🚀 Quick Start" icon="rocket" href="#quick-example">
    Get up and running in 5 minutes
  </Card>

  <Card title="📚 API Reference" icon="code" href="/api-reference/endpoint/single-validation">
    Complete endpoint documentation
  </Card>

  <Card title="🔐 Authentication" icon="key" href="/api-concepts/authentication">
    Secure API access guide
  </Card>

  <Card title="⚡ Rate Limits" icon="gauge" href="/api-concepts/rate-limiting">
    Understand usage limits
  </Card>
</CardGroup>

## What you can do with this API

> **Validate a single email**\
> Check if an email is deliverable, risky, disposable, or part of a catch-all domain.

> **Process bulk lists**\
> Upload large lists and retrieve validation results asynchronously.

> **Enrich contact data**\
> Retrieve metadata such as name, gender, and email attributes when available.

> **Monitor usage**\
> Access account usage, credit balance, and validation statistics programmatically.

## How it works

<Steps>
  <Step title="Get your API key">
    Log in to your DeBounce dashboard to access your private API key.
  </Step>

  <Step title="Send requests">
    Use the appropriate API endpoint for single email validation, bulk processing, or enrichment.
  </Step>

  <Step title="Handle responses">
    Each API call returns a structured JSON response containing status details and metadata.
  </Step>
</Steps>

## Quick Example

```bash theme={null}
curl "https://api.debounce.io/v1/?email=user@example.com&api_key=YOUR_API_KEY"
```

**Response:**

```json theme={null}
{
  "debounce": {
    "email": "testemail@gmail.com",
    "code": "5",
    "role": "false",
    "free_email": "true",
    "result": "Safe to Send",
    "reason": "Deliverable",
    "send_transactional": "1",
    "did_you_mean": ""
  },
  "success": "1",
  "balance": "14999"
}
```

## Before you start

* You will need an API key tied to your DeBounce account
* Each feature has its own endpoint and response structure
* Validation speed depends on usage tier and selected methods
* Bulk processing workflows operate asynchronously

## Next steps

* Learn about **Authentication**
* Explore **Single Email Validation**
* Review **Bulk Upload** processing
* Check **Enrichment** features