Skip to main content

​
Setup Your Account

1

Sign Up

Create your account at gtmapis.vercel.app
2

Get Your API Key

Navigate to Dashboard → API Keys and generate a test keyAPI keys follow this format:
  • Test keys: gtm_test_1234567890abcdef...
  • Live keys: gtm_live_1234567890abcdef...
3

Make Your First Request

Validate your first email with a simple cURL request

​
Validate a Single Email

curl -X POST https://api.gtmapis.com/v1/validate \
  -H "Content-Type: application/json" \
  -H "X-API-Key: gtm_test_your_key_here" \
  -d '{"email":"john@company.com"}'

​
Response Format

{
  "email": "john@company.com",
  "result": "valid",
  "reason": "",
  "is_role_based": false,
  "is_free_provider": false,
  "b2b_outbound_quality": "high",
  "credits_charged": 1,
  "charge_reason": "Valid personal email with high B2B outbound quality"
}
​
result
string
required
Validation result: valid, valid_role_based, risky, invalid, or unknown
​
b2b_outbound_quality
string
required
B2B quality score: high, low, or none
​
credits_charged
integer
required
Number of credits charged (0 or 1). Only high-value personal emails are charged.

​
Validate Multiple Emails

Process up to 100 emails in a single request: 
curl -X POST https://api.gtmapis.com/v1/validate/bulk \
  -H "Content-Type: application/json" \
  -H "X-API-Key: gtm_test_your_key_here" \
  -d '{
    "emails": [
      "john@company.com",
      "info@company.com",
      "invalid@fakeemail123.com"
    ]
  }'

​
Understanding Credit Charges

Only pay for emails that matter:
ResultB2B QualityCredits ChargedExample
validhigh✅ 1 creditjohn@company.com
valid_role_basedlow🆓 FREEinfo@company.com
riskynone🆓 FREEcatch-all domains
invalidnone🆓 FREEinvalid@notreal.com

​
Next Steps

Validation Pipeline

Learn how our 4-layer validation works

B2B Quality Scoring

Understand how we score emails for outbound value

API Reference

Complete API documentation

CSV Upload Guide

Upload and validate CSV files