Skip to main content

​
Prerequisites

  • A RevenueBase account
  • An API key from Dashboard → API Keys
Set your key as an environment variable. The Python SDK reads REVENUEBASE_API_KEY automatically — no explicit configuration needed. 
export REVENUEBASE_API_KEY=your_api_key_here
To use the Python SDK, install it first: 
pip install revenuebase-sdk
1

Check your credit balance

Confirm your key works and see how many credits you have available.
curl https://api.revenuebase.ai/v2/account/balance \
  -H "x-key: $REVENUEBASE_API_KEY"
Expected response:
{
  "balance": 1000
}
Each credit is consumed by a successful verification. Valid and Invalid results each deduct one credit; Unknown results do not.
If you get a 401 Unauthorized, check that the header is x-key (not Authorization) and that you copied the full key with no trailing spaces.
2

Verify a single email

Send an email address to the verification endpoint.
curl -X POST https://api.revenuebase.ai/v2/email/verify \
  -H "x-key: $REVENUEBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "jamie.morgan@acmecorp.com"}'
Response:
{
  "email": "jamie.morgan@acmecorp.com",
  "status": "Valid"
}
The status field tells you whether the address is deliverable:
StatusMeaningCredits deducted
ValidAddress is deliverable — safe to send1
InvalidAddress does not exist or is undeliverable1
UnknownCould not determine deliverability (e.g. catch-all domain)0
Add ?metadata=true for additional fields:
curl -X POST "https://api.revenuebase.ai/v2/email/verify?metadata=true" \
  -H "x-key: $REVENUEBASE_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "jamie.morgan@acmecorp.com"}'

{
  "email": "jamie.morgan@acmecorp.com",
  "status": "Valid",
  "domain": "acmecorp.com",
  "timestamp": "2024-01-15T10:30:00",
  "mx_record_present": true,
  "mx_record_checked": "checked",
  "email_provider": "Google",
  "security_gateway": null,
  "reason": null
}

​
What next