API Documentation

Integrate GetNoBounce email verification into your applications with our powerful REST API. Real-time verification with detailed results.

Real-time verification

99.9% uptime

Detailed verification results

Global infrastructure

Quick Start

1. Sign up for a GetNoBounce account

2. Generate an API key from your dashboard

3. Make your first API call

4. Start verifying emails!

Base URL

https://admired-cheetah-827.convex.site/api/v1

Quick Example

curl -X POST https://admired-cheetah-827.convex.site/api/v1/verify \
  -H "Authorization: Bearer gnb_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "user@example.com"}'

Authentication

All API requests must include your API key in the Authorization header using Bearer authentication.

Header Format

Authorization: Bearer gnb_YOUR_API_KEY

Getting Your API Key

1. Log in to your GetNoBounce dashboard

2. Navigate to the API section

3. Click "Create API Key"

4. Give your key a descriptive name

5. Copy and securely store your API key

⚠️ Security Note: Keep your API keys secure and never expose them in client-side code. API keys have the same permissions as your account.

API Endpoints

POST /verify

Verify a single email address and get detailed results.

Request Body

{
  "email": "user@example.com"
}

Response

{
  "email": "user@example.com",
  "verified": true,
  "result": {
    "deliverable": true,
    "reachable": "yes",
    "valid_format": true,
    "mx_records": true,
    "smtp": {
      "deliverable": true,
      "host_exists": true,
      "catch_all": false,
      "full_inbox": false,
      "disabled": false
    },
    "disposable": false,
    "role_account": false,
    "free_provider": false,
    "has_gravatar": false
  },
  "credits_remaining": 99
}

Response Fields

deliverable - Boolean indicating if the email is deliverable

reachable - Status: "yes", "no", "unknown", or "error"

valid_format - Email format validation result

mx_records - Domain has valid MX records

smtp.deliverable - SMTP server accepts the email

smtp.host_exists - SMTP host server exists

smtp.catch_all - Domain accepts all emails (catch-all)

smtp.full_inbox - Mailbox is full

smtp.disabled - Email account is disabled

disposable - Temporary/disposable email detection

role_account - Role-based email (info@, support@, etc.)

free_provider - Free email provider (Gmail, Yahoo, etc.)

has_gravatar - Email has an associated Gravatar

credits_remaining - Your remaining credit balance

Rate Limits & Pricing

• Each verification consumes 1 credit from your account

• No rate limits - scale as needed

• Pay-as-you-go pricing with no monthly fees

• Credits never expire

Code Examples

curl -X POST https://admired-cheetah-827.convex.site/api/v1/verify \
  -H "Authorization: Bearer gnb_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "user@example.com"}'

Error Handling

HTTP Status Codes

200 - Success

400 - Bad Request (invalid email format or missing parameters)

401 - Unauthorized (invalid or missing API key)

402 - Payment Required (insufficient credits)

429 - Too Many Requests (rate limit exceeded)

500 - Internal Server Error

Error Response Format

{
  "error": "Invalid API key",
  "message": "The provided API key is invalid or has been revoked"
}

Common Errors

Invalid API Key

Check that your API key is correct and hasn't been revoked

Insufficient Credits

Purchase more credits from your dashboard

Invalid Email Format

Ensure the email address is properly formatted

Need Help?

Our support team is here to help you integrate and get the most out of our API.

📧 support@getnobounce.com

💬 Live chat in dashboard