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