Make your first API call

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

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"

from revenuebase_sdk import RevenuebaseClient

client = RevenuebaseClient()

result = client.account.balance()
print(result.balance)

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.

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"}'

from revenuebase_sdk import RevenuebaseClient

client = RevenuebaseClient()

result = client.email.verify(email="jamie.morgan@acmecorp.com")
print(result.status)

Response:

{
  "email": "jamie.morgan@acmecorp.com",
  "status": "Valid"
}

The status field tells you whether the address is deliverable:

Status	Meaning	Credits deducted
`Valid`	Address is deliverable — safe to send	1
`Invalid`	Address does not exist or is undeliverable	1
`Unknown`	Could 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"}'

result = client.email.verify(email="jamie.morgan@acmecorp.com", metadata=True)
print(result.email_provider)

{
  "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

Overview

⌘I

Quickstart

Email Verification

Organization Match

Job Processes

Account Management

v1 Reference (Deprecated)

Make your first API call

Prerequisites

What next

​Prerequisites

​What next

Prerequisites

What next