### Fetch Company Logo by Domain (JavaScript)

Source: https://developers.debounce.com/api-reference/endpoint/free/logo-api

Provides examples of how to use the Logo API in JavaScript. Includes a simple image loading example with `onload` and `onerror` event handlers, and a React component for dynamically displaying company logos.

```javascript
// Simple image loading
const img = new Image();
img.onload = () => console.log('Logo loaded successfully');
img.onerror = () => console.log('Logo failed to load');
img.src = 'https://logo.debounce.com/google.com';

// React component example
function CompanyLogo({ domain, size = 128 }) {
  return (
    <img
      src={`https://logo.debounce.com/${domain}`}
      alt={`${domain} logo`}
      width={size}
      height={size}
      onError={(e) => {
        // Optional: handle fallback locally
        e.target.style.display = 'none';
      }}
    />
  );
}
```

--------------------------------

### GET /v1/upload/

Source: https://developers.debounce.com/api-reference/endpoint/bulk/upload

Initiates a bulk email validation process by providing a publicly accessible URL to an email list file.

```APIDOC
## GET /v1/upload/

### Description
Perform a bulk email validation request via API by providing a URL to your email list file.

### Method
GET

### Endpoint
https://bulk.debounce.io/v1/upload/

### Parameters
#### Query Parameters
- **api** (string) - Required - Your DeBounce API key.
- **url** (string) - Required - URL of your .csv or .txt email list, starting with https and hosted on your server.

### Request Example
GET https://bulk.debounce.io/v1/upload/?api=YOUR_API_KEY&url=https://example.com/list.csv

### Response
#### Success Response (200)
- **debounce.list_id** (string) - Unique identifier for the uploaded list.
- **debounce.list_name** (string) - Name of the uploaded list.
- **success** (string) - Indicates if the upload was successful ('1').

#### Response Example
{
  "debounce": {
    "list_id": "8620",
    "list_name": "test-list"
  },
  "success": "1"
}
```

--------------------------------

### GET /v1/validate

Source: https://developers.debounce.com/api-reference/endpoint/single-validation

Validates an email address and returns deliverability status, transactional suggestions, and remaining account balance.

```APIDOC
## GET /v1/validate

### Description
Validates the provided email address to determine if it is safe to send transactional emails and returns the remaining account balance.

### Method
GET

### Endpoint
/v1/validate

### Parameters
#### Query Parameters
- **email** (string) - Required - The email address to validate.
- **api** (string) - Required - Your API key for authentication.

### Request Example
GET /v1/validate?email=test@example.com&api=YOUR_API_KEY

### Response
#### Success Response (200)
- **reason** (string) - The reason why the result is given (e.g., "Deliverable").
- **send_transactional** (integer) - Suggested send status (0: no, 1: yes).
- **did_you_mean** (string) - Suggested corrected email if a typo is detected.
- **success** (integer) - Indicates if the call was successful (0: no, 1: yes).
- **balance** (integer) - Remaining balance on your account.

#### Response Example
{
  "reason": "Deliverable",
  "send_transactional": 1,
  "did_you_mean": "",
  "success": 1,
  "balance": 4921
}
```

--------------------------------

### GET /logo.debounce.com/{domain}

Source: https://developers.debounce.com/api-reference/endpoint/free/logo-api

Retrieves a company logo in PNG format based on the provided domain name.

```APIDOC
## GET https://logo.debounce.com/{domain}

### Description
Fetches a high-quality company logo by domain name. Returns a PNG image directly. If no logo is found, a clean grey monogram placeholder is returned.

### Method
GET

### Endpoint
https://logo.debounce.com/{domain}

### Parameters
#### Path Parameters
- **domain** (string) - Required - The domain name of the company (e.g., google.com)

### Request Example
GET https://logo.debounce.com/google.com

### Response
#### Success Response (200)
- **Content-Type** (image/png) - The response body contains the raw PNG image data.

#### Response Example
[Binary PNG Image Data]
```

--------------------------------

### GET /v1/usage/

Source: https://developers.debounce.com/api-reference/endpoint/miscellaneous/usage

Fetches your daily API usage and credit consumption for a given date range. It returns the number of validations performed each day.

```APIDOC
## GET /v1/usage/

### Description
Fetches your daily API usage and credit consumption for a given date range. It returns the number of validations performed each day.

### Method
GET

### Endpoint
/v1/usage/

### Parameters
#### Query Parameters
- **api** (string) - Required - Your DeBounce API key
- **start** (string) - Required - Start date in YY-MM-DD format. Must be after 20-08-14.
- **end** (string) - Required - End date in YY-MM-DD format. Must be equal to or less than today's date.

### Request Example
```
/v1/usage/?start=24-01-01&end=24-01-31&api=YOUR_API_KEY
```

### Response
#### Success Response (200)
- **debounce** (object) - Contains API usage details.
  - **api** (string) - API key identifier.
  - **start** (string) - Start date of the query.
  - **end** (string) - End date of the query.
  - **calls** (string) - Number of API calls made within the specified range.
- **success** (string) - Indicates if the request was successful ('1' for success, '0' for failure).

#### Response Example
```json
{
  "debounce": {
    "api": "YOUR API KEY",
    "start": "24-01-01",
    "end": "24-12-31",
    "calls": "100"
  },
  "success": "1"
}
```
```

--------------------------------

### GET / Authentication

Source: https://developers.debounce.com/api-concepts/authentication

Authentication is handled via a query parameter appended to every API request URL.

```APIDOC
## GET / 

### Description
Authenticates requests to the DeBounce API by appending a unique API key to the query string.

### Method
GET

### Endpoint
https://api.debounce.io/

### Parameters
#### Query Parameters
- **api** (string) - Required - Your 13-character alphanumeric API key.
- **email** (string) - Optional - The email address to validate (example usage).

### Request Example
curl -X GET "https://api.debounce.io/?api=YOUR_API_KEY&email=example@gmail.com"

### Response
#### Success Response (200)
- **status** (string) - The status of the validation request.

#### Response Example
{
  "success": true,
  "email": "example@gmail.com",
  "status": "deliverable"
}
```

--------------------------------

### GET /v1/status/

Source: https://developers.debounce.com/api-reference/endpoint/bulk/status

Retrieves the validation status for a given list ID. It indicates whether the list is queued, processing, or completed, and provides a download link for the results when available.

```APIDOC
## GET /v1/status/

### Description
Check the progress of a list previously uploaded through the bulk validation API. Once processing is complete, the response includes a link to download the results as a .csv file.

### Method
GET

### Endpoint
/v1/status/

### Parameters
#### Query Parameters
- **list_id** (string) - Required - The list ID returned from the upload request

### Request Example
```json
{
  "example": ""
}
```

### Response
#### Success Response (200)
- **debounce** (object) - Contains validation status details.
  - **list_id** (string) - Unique identifier for the list.
  - **status** (string) - Current processing status (processing, completed).
  - **percentage** (integer) - Processing completion percentage (0-100).
  - **download_link** (string) - Download link for completed results.
- **success** (string) - Whether the status request was successful ('0' or '1').

#### Response Example
```json
{
  "example": "{\n  \"debounce\": {\n    \"list_id\": \"20664\",\n    \"status\": \"completed\",\n    \"percentage\": 100,\n    \"download_link\": \"https://cdn.debounce.io/get/report/20664-5efwsdbsccsd.csv\"\n  },\n  \"success\": \"1\"\n}"
}
```
```

--------------------------------

### GET /v1/balance/

Source: https://developers.debounce.com/api-reference/endpoint/miscellaneous/balance

Retrieves the current account balance, which represents the number of remaining validation credits.

```APIDOC
## GET /v1/balance/

### Description
Fetches the current account balance, indicating the number of remaining validation credits.

### Method
GET

### Endpoint
/v1/balance/

### Parameters
#### Query Parameters
- **api** (apiKey) - Required - Your DeBounce API key

### Request Example
```json
{
  "api": "YOUR API KEY"
}
```

### Response
#### Success Response (200)
- **balance** (string) - The current account balance as a string.
- **success** (integer) - Indicates if the request was successful (0 for failure, 1 for success).

#### Response Example
```json
{
  "balance": "1087306"
}
```

#### Error Response (401)
- **error** (string) - Description of the error.
- **message** (string) - Additional error message.
- **debounce.error** (string) - DeBounce specific error message.
- **debounce.code** (string) - DeBounce specific error code.
- **success** (string) - Always '0' for error responses.

#### Error Response Example
```json
{
  "debounce": {
    "error": "Wrong API",
    "code": "0"
  },
  "success": "0"
}
```
```

--------------------------------

### GET /api-reference/endpoint/single-validation

Source: https://developers.debounce.com/api-reference/endpoint/enrichment

Enrich email address data by appending full name and avatar information to standard validation results.

```APIDOC
## GET /api-reference/endpoint/single-validation

### Description
Retrieve enriched contact information such as full name and avatar from an email address using the DeBounce data enrichment engine.

### Method
GET

### Endpoint
/api-reference/endpoint/single-validation

### Parameters
#### Query Parameters
- **email** (string) - Required - The email address to validate and enrich.
- **append** (boolean) - Optional - Set to 'true' to retrieve full name and avatar (Costs 20 extra credits).
- **photo** (boolean) - Optional - Set to 'true' to retrieve only the avatar (Costs 1 extra credit).

### Request Example
GET /api-reference/endpoint/single-validation?email=example@domain.com&append=true

### Response
#### Success Response (200)
- **full_name** (string) - The full name associated with the email.
- **avatar_url** (string) - The URL of the user's profile photo.
- **status** (string) - The validation status of the email.

#### Response Example
{
  "full_name": "John Doe",
  "avatar_url": "https://example.com/avatar.jpg",
  "status": "deliverable"
}
```

--------------------------------

### Handle Public API Daily Limit Error

Source: https://developers.debounce.com/api-concepts/rate-limiting

Example of the HTTP 429 error response returned when a public API key exceeds the daily per-IP validation limit. This informs the client-side widget to display a restriction message.

```json
HTTP/429 Too Many Requests
{
  "debounce": {
    "error": "Authentication Failed - The maximum number of calls per day reached."
  },
  "success": "0"
}
```

--------------------------------

### Handle API Success Response

Source: https://developers.debounce.com/api-concepts/responses

Example of a successful API response structure. It includes the 'debounce' data object, a success flag set to '1', and the remaining account balance.

```json
HTTP/1.1 200 OK

{
  "debounce": {
    "email": "mohsen@gmail.com",
    "code": "5",
    "role": "false",
    "free_email": "true",
    "result": "Safe to Send",
    "reason": "Deliverable",
    "send_transactional": "1",
    "did_you_mean": ""
  },
  "success": "1",
  "balance": "1725935"
}
```

--------------------------------

### GET /v1/ - Validate Single Email Address

Source: https://developers.debounce.com/api-reference/endpoint/single-validation

Validates a single email address and returns detailed validation results. This endpoint requires an API key and provides information about the email's deliverability.

```APIDOC
## GET /v1/

### Description
Validates a single email address and returns detailed validation results.

### Method
GET

### Endpoint
https://api.debounce.io/v1/

### Parameters
#### Query Parameters
- **api** (string) - Required - Your DeBounce API key
- **email** (string) - Required - The email address you want to validate
- **photo** (boolean) - Optional - If set to true, returns profile photo (extra credits apply)
- **append** (boolean) - Optional - If set to true, enriches with full name and avatar (extra credits apply)
- **gsuite** (boolean) - Optional - If set to true, detects G Suite accept-all emails

### Request Example
```json
{
  "example": "https://api.debounce.io/v1/?api=API_KEY&email=someemail@gmail.com&photo=true"
}
```

### Response
#### Success Response (200)
- **debounce** (object) - Contains validation details.
  - **email** (string) - The validated email address.
  - **code** (integer) - DeBounce validation response code.
  - **role** (boolean) - Indicates if the email is role-based.
  - **free_email** (boolean) - Indicates if the email is from a free provider.
  - **result** (string) - The final validation result (e.g., 'Safe to Send').
  - **reason** (string) - The reason for the validation result.
  - **send_transactional** (string) - Indicates if transactional sending is allowed.
  - **did_you_mean** (string) - Suggestion for a similar email if applicable.
- **success** (string) - Indicates the success of the API call ('1' for success).
- **balance** (string) - Remaining credits on your account.

#### Error Response (401, 402, 429)
- **debounce** (object) - Contains error details.
  - **error** (string) - Description of the error.
  - **code** (string) - Error code.
- **success** (string) - Indicates the failure of the API call ('0' for failure).

#### Response Example (Success)
```json
{
  "example": {
    "debounce": {
      "email": "someemail@gmail.com",
      "code": "5",
      "role": "false",
      "free_email": "true",
      "result": "Safe to Send",
      "reason": "Deliverable",
      "send_transactional": "1",
      "did_you_mean": ""
    },
    "success": "1",
    "balance": "329918"
  }
}
```

#### Response Example (Error - Invalid API Key)
```json
{
  "example": {
    "debounce": {
      "error": "Wrong API",
      "code": "0"
    },
    "success": "0"
  }
}
```
```

--------------------------------

### Example API Response for Single Email Validation

Source: https://developers.debounce.com/index

This JSON object represents a typical response from the DeBounce API after validating a single email. It includes the email, validation code, result, reason, and other relevant metadata, along with the account's remaining balance.

```json
{
  "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"
}
```

--------------------------------

### Handle Rate Limit Error Response

Source: https://developers.debounce.com/api-concepts/rate-limiting

Example of the HTTP 429 error response returned by the DeBounce API when concurrency limits are exceeded. This JSON structure indicates the specific error message and status code.

```json
HTTP/429 Too Many Requests
{
  "debounce": {
    "error": "Maximum concurrent calls reached",
    "code": "0"
  },
  "success": "0"
}
```

--------------------------------

### Handle API Error Response

Source: https://developers.debounce.com/api-concepts/responses

Example of an error response structure. When a request fails, the 'success' flag is set to '0' and the 'debounce' object provides specific error information.

```json
HTTP/1.1 401 Unauthorized

{
  "debounce": {
    "error": "Wrong API",
    "code": "0"
  },
  "success": "0"
}
```

--------------------------------

### Quick Start: Validate Single Email with cURL

Source: https://developers.debounce.com/index

This snippet demonstrates how to validate a single email address using the DeBounce API via a cURL command. It requires your API key and the email to be validated. The response is a JSON object containing validation details and your account balance.

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

--------------------------------

### GET / - Check Disposable Email

Source: https://developers.debounce.com/api-reference/endpoint/free/disposible-detector

Checks if a given email address or domain is associated with a disposable email service. This endpoint is free to use and supports CORS.

```APIDOC
## GET /

### Description
Checks if a given email address or domain is associated with a disposable email service. This endpoint is free to use and supports CORS.

### Method
GET

### Endpoint
https://disposable.debounce.io/

### Parameters
#### Query Parameters
- **email** (string) - Required - The email address or domain to check

### Response
#### Success Response (200)
- **disposable** (string) - Whether the email/domain is disposable

#### Response Example
```json
{
  "disposable": "true"
}
```
```

--------------------------------

### OpenAPI Specification for Disposable Email Detector

Source: https://developers.debounce.com/api-reference/endpoint/free/disposible-detector

The OpenAPI 3.1.0 specification defines the endpoint for checking disposable emails. It details the GET request structure, query parameters for the email address, and the expected JSON response indicating whether the email is disposable.

```yaml
openapi: 3.1.0
info:
  title: DeBounce Disposable Email Detector API
  description: Free disposable email and domain checker.
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://disposable.debounce.io
security: []
paths:
  /:
    get:
      summary: Check disposable email
      description: >-
        Free API as easy as hitting a URL. Check an email address against a
        real-time, up-to-date list of disposable domains.
      operationId: checkDisposableEmail
      parameters:
        - name: email
          in: query
          description: The email address or domain to check
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Disposable email check completed successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/DisposableResult'
              examples:
                example:
                  value:
                    disposable: 'true'
      security: []
components:
  schemas:
    DisposableResult:
      type: object
      required:
        - disposable
      properties:
        disposable:
          description: Whether the email/domain is disposable
          type: string
```

--------------------------------

### Public API Key Limits

Source: https://developers.debounce.com/api-concepts/rate-limiting

Guidelines for client-side JavaScript usage, including CORS requirements and per-IP daily limits.

```APIDOC
## Rate Limiting: Public API Key

### Description
Public API keys (prefixed with `public_`) are designed for client-side JavaScript implementations. Usage is restricted by IP address to prevent abuse.

### Requirements
- **CORS**: Domains must be added to the approved CORS list in the dashboard.
- **Daily Limit**: Maximum of 20 emails per IP address per day.

### Response Example (429)
{
  "debounce": {
    "error": "Authentication Failed - The maximum number of calls per day reached."
  },
  "success": "0"
}
```

--------------------------------

### Rate Limiting Overview

Source: https://developers.debounce.com/api-concepts/rate-limiting

Details regarding concurrency limits for regular API keys and error handling for exceeded thresholds.

```APIDOC
## Rate Limiting: Regular API Key

### Description
Regular (private) API keys are subject to concurrency limits to ensure system stability and performance.

### Concurrency Limits
- **Standard Limit**: Up to 5 concurrent API calls.
- **Data Enrichment Enabled**: Up to 2 concurrent API calls.

### Error Handling
If the concurrency limit is exceeded, the API returns a 429 status code.

### Response Example (429)
{
  "debounce": {
    "error": "Maximum concurrent calls reached",
    "code": "0"
  },
  "success": "0"
}
```

--------------------------------

### OpenAPI Specification for Account Balance

Source: https://developers.debounce.com/api-reference/endpoint/miscellaneous/balance

The OpenAPI 3.1.0 definition for the /v1/balance/ endpoint. It outlines the required API key authentication, request parameters, and the expected success and error response schemas.

```yaml
openapi: 3.1.0
info:
  title: DeBounce Email Validation API
  version: 1.0.0
paths:
  /v1/balance/:
    get:
      summary: Get account balance
      operationId: getBalance
      parameters:
        - name: api
          in: query
          required: true
          schema:
            type: apiKey
      responses:
        '200':
          description: Account balance retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BalanceResult'
```

--------------------------------

### Retrieve usage statistics via API endpoint

Source: https://developers.debounce.com/api-reference/endpoint/miscellaneous/usage

Demonstrates the URL structure for querying daily usage statistics. Requires a valid API key and a date range in YY-MM-DD format.

```http
/v1/usage/?start=24-01-01&end=24-01-31&api=YOUR_API_KEY
```

--------------------------------

### Fetch Company Logo by Domain (HTML)

Source: https://developers.debounce.com/api-reference/endpoint/free/logo-api

Demonstrates how to embed a company logo directly into an HTML document using an image tag. The `src` attribute is set to the API endpoint with the company's domain.

```html
<img src="https://logo.debounce.com/google.com" alt="Google Logo" width="128" height="128">
```

--------------------------------

### Define usage statistics endpoint in OpenAPI

Source: https://developers.debounce.com/api-reference/endpoint/miscellaneous/usage

The OpenAPI 3.1.0 specification for the /v1/usage/ endpoint. It defines the required query parameters, authentication via API key, and the expected JSON response schema.

```yaml
openapi: 3.1.0
info:
  title: DeBounce Email Validation API
  version: 1.0.0
paths:
  /v1/usage/:
    get:
      summary: Get usage statistics
      operationId: getUsage
      parameters:
        - name: api
          in: query
          required: true
          schema:
            type: string
        - name: start
          in: query
          required: true
          schema:
            type: string
            pattern: ^\d{2}-\d{2}-\d{2}$
        - name: end
          in: query
          required: true
          schema:
            type: string
            pattern: ^\d{2}-\d{2}-\d{2}$
```

--------------------------------

### General URL Structure

Source: https://developers.debounce.com/api-concepts/request

DeBounce API requests follow a standard URL format consisting of a hostname, path, and query parameters. This structure allows for flexible data retrieval and validation.

```APIDOC
## General URL Structure

Most requests follow this format:

```
https://{hostname}/{path}?{parameters}
```

Where each component has a specific role:

| Component      | Description                                                                                                          |
| -------------- | -------------------------------------------------------------------------------------------------------------------- |
| **hostname**   | The service domain handling the request, such as `api.debounce.io`, `bulk.debounce.io`, or `disposable.debounce.io`. |
| **path**       | The specific API route being called, such as `single`, `bulk/status`, or `free/disposable`.                          |
| **parameters** | Query parameters that define the request, such as the email address, API key, or file token.                         |

## Common URL Parameters

DeBounce endpoints rely on simple query-string parameters. Common examples include:

* `api` — your API key
* `email` — email address to validate
* `task_id` — reference to a bulk validation job
* `file` — file token used for retrieving bulk results

<Note>
  Each endpoint documents its required and optional parameters individually.
</Note>
```

--------------------------------

### Authenticate API Request with API Key (Bash)

Source: https://developers.debounce.com/api-concepts/authentication

This snippet demonstrates how to authenticate a DeBounce API request using a cURL command. It shows how to include the API key and an email parameter in the request URL. Ensure you replace 'YOUR_API_KEY' with your actual API key.

```bash
curl -X GET "https://api.debounce.io/?api=YOUR_API_KEY&email=example@gmail.com"
```

--------------------------------

### Bulk Validation Limits

Source: https://developers.debounce.com/api-concepts/rate-limiting

Rules governing bulk validation jobs, which are serialized to maintain system stability.

```APIDOC
## Bulk Validation Limits

### Description
Bulk validation jobs are processed sequentially to ensure system stability and predictable processing times.

### Rules
- **Active Jobs**: Only one active bulk validation job is permitted per account.
- **Queueing**: Additional jobs are automatically queued and processed sequentially once the active job completes.
```

--------------------------------

### OpenAPI Specification for DeBounce Email Validation API

Source: https://developers.debounce.com/api-reference/endpoint/single-validation

This YAML document defines the OpenAPI 3.1.0 specification for the DeBounce Email Validation API. It details the available endpoints, including parameters, request/response schemas, and authentication methods. This specification can be used to generate client libraries and documentation.

```yaml
openapi: 3.1.0
info:
  title: DeBounce Email Validation API
  description: Single email validation, reverse lookup, balance, and usage endpoints.
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.debounce.io
security:
  - ApiKeyQuery: []
paths:
  /v1/: 
    get:
      summary: Validate Single Email Address
      description: Validates a single email address and returns detailed validation results
      operationId: validateEmail
      parameters:
        - name: api
          in: query
          required: true
          schema:
            type: string
            example: API_KEY
          description: Your DeBounce API key
        - name: email
          in: query
          required: true
          schema:
            type: string
            format: email
          description: The email address you want to validate
        - name: photo
          in: query
          required: false
          schema:
            type: boolean
          description: If set to true, returns profile photo (extra credits apply)
        - name: append
          in: query
          required: false
          schema:
            type: boolean
          description: >-
            If set to true, enriches with full name and avatar (extra credits
            apply)
        - name: gsuite
          in: query
          required: false
          schema:
            type: boolean
          description: If set to true, detects G Suite accept-all emails
      responses:
        '200':
          description: Validation successful
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationResult'
              examples:
                example:
                  value:
                    debounce:
                      email: someemail@gmail.com
                      code: '5'
                      role: 'false'
                      free_email: 'true'
                      result: Safe to Send
                      reason: Deliverable
                      send_transactional: '1'
                      did_you_mean: ''
                    success: '1'
                    balance: '329918'
        '401':
          description: Invalid API Key
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                debounce:
                  error: Wrong API
                  code: '0'
                success: '0'
        '402':
          description: Credits Low
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                debounce:
                  error: Credits Low
                  code: '0'
                success: '0'
        '429':
          description: Too Many Requests / Daily Limit Reached
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              examples:
                tooManyRequests:
                  summary: Too many concurrent calls
                  value:
                    debounce:
                      error: Maximum concurrent calls reached
                      code: '0'
                    success: '0'
                dailyLimit:
                  summary: Daily limit reached (Public API key)
                  value:
                    debounce:
                      error: >-
                        Authentication Failed - The maximum number of calls per
                        day reached.
                    success: '0'
components:
  schemas:
    ValidationResult:
      type: object
      required:
        - email
        - result
        - success
      properties:
        email:
          description: The email address you are requesting to validate.
          type: string
          format: email
          example: test@example.com
        code:
          description: >-
            DeBounce validation response code. To understand DeBounce results
            and codes, visit
            https://help.debounce.com/understanding-results/result-codes/.
          type: integer
          example: 1
        role:
          description: >-
            Is the email role-based or not. Role emails such as "sales@",
            "webmaster@" etc., are not suitable for sending marketing emails to.
          type: boolean
          example: false
        free_email:
          description: Is the email from a free email provider - like Gmail - or not.
          type: boolean
          example: true
        result:
          description: >-
            The final result of the validation process. This response will help
            to determine whether you should send marketing emails to a recipient
            or not.
          type: string
          enum:
            - Invalid
            - Risky
            - Safe to Send

```

--------------------------------

### Retrieve Account Balance JSON Response

Source: https://developers.debounce.com/api-reference/endpoint/miscellaneous/balance

The Account Balance endpoint returns a JSON object containing the current credit balance as a string. This is a read-only operation used to monitor usage and prevent workflow interruptions.

```json
{
  "balance": "1087306"
}
```

--------------------------------

### Single Email Validation

Source: https://developers.debounce.com/index

Validate a single email address to check its deliverability, risk, disposable status, or if it belongs to a catch-all domain.

```APIDOC
## GET /v1/

### Description
Validates a single email address.

### Method
GET

### Endpoint
`/v1/`

### Query Parameters
- **email** (string) - Required - The email address to validate.
- **api_key** (string) - Required - Your DeBounce API key.

### Request Example
```bash
curl "https://api.debounce.io/v1/?email=user@example.com&api_key=YOUR_API_KEY"
```

### Response
#### Success Response (200)
- **debounce** (object) - Contains validation details.
  - **email** (string) - The validated email address.
  - **code** (string) - Validation code.
  - **role** (string) - Indicates if the email is a role-based account.
  - **free_email** (string) - Indicates if the email is from a free provider.
  - **result** (string) - The validation result (e.g., "Safe to Send").
  - **reason** (string) - The reason for the validation result.
  - **send_transactional** (string) - Indicates if transactional emails can be sent.
  - **did_you_mean** (string) - Suggestion if the email was misspelled.
- **success** (string) - Indicates if the request was successful ('1' for success).
- **balance** (string) - Remaining credit balance.

#### Response Example
```json
{
  "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"
}
```
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.