checkharbor 0.1.0

Official Checkharbor Python SDK — email/phone/IP validation

checkharbor

Official Checkharbor Python SDK.

Install

pip install checkharbor

Quick start

from checkharbor import Checkharbor

client = Checkharbor(api_key="chk_live_...")

# Validate email
email = client.validate_email("[e-mail]")
print(email["score"], email["deliverability"])

# Validate phone
phone = client.validate_phone("[phone]", country_hint="TR")

# IP intelligence
ip = client.ip_intel("84.17.45.10")

# Unified fraud check
fraud = client.verify(email="[e-mail]", ip="84.17.45.10")
print(fraud["fraud_score"], fraud["risk"])

# Batch
job = client.batch.create(
    type="email",
    rows=["[e-mail]", "[e-mail]"],
    webhook_url="https://myapp.com/webhook",
)
done = client.batch.wait_until_done(job["id"])
csv = client.batch.download_result(done)

Error handling

from checkharbor import CheckharborError

try:
    result = client.validate_email("[e-mail]")
except CheckharborError as e:
    print(e.code, e.status, str(e))
    # e.g. "insufficient_credits" 402 "Not enough credits"

Development

python3 -m venv .venv && source .venv/bin/activate
pip install -e ".[dev]"
pytest