Examples

import requests

HEADERS = {"Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json"}

def is_deliverable(email: str) -> bool:
    r = requests.post(
        "https://developer.encrata.com/api/lookup/email/validity",
        headers=HEADERS, json={"email": email},
    )
    return r.json()["status"] == "valid"

for email in ["satya@microsoft.com", "user@tempmail.com"]:
    if is_deliverable(email):
        send_welcome_email(email)

import requests

HEADERS = {"Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json"}

r = requests.post(
    "https://developer.encrata.com/api/lookup/email/identity",
    headers=HEADERS, json={"email": "jane@acme.com"},
)
person = r.json()["person"]

crm.create_contact(
    name=f"{person.get('first_name', '')} {person.get('last_name', '')}".strip(),
    company=person.get("company"),
    title=person.get("job_role"),
    linkedin=person.get("socials", {}).get("linkedin"),
)

import requests

HEADERS = {"Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json"}

r = requests.post(
    "https://developer.encrata.com/api/lookup/email/gender",
    headers=HEADERS, json={"email": "jane.doe@example.com"},
)
g = r.json()

title = {"male": "Mr.", "female": "Ms."}.get(g["gender"]) if g["probability"] >= 90 else None
greeting = f"Dear {title} Doe," if title else "Hi there,"

import requests

HEADERS = {"Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json"}

r = requests.post(
    "https://developer.encrata.com/api/lookup/email/compliance",
    headers=HEADERS, json={"email": "priya.sharma@example.in"},
)
result = r.json()["result"]

if result["recommendation_code"] in ("prohibited", "consent_required"):
    print(f"Hold: {result['recommendation']}")
else:
    send_cold_email("priya.sharma@example.in")

import requests

HEADERS = {"Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json"}

r = requests.post(
    "https://developer.encrata.com/api/lookup/email/breaches",
    headers=HEADERS, json={"email": "user@example.com"},
)
data = r.json()

if data["breached"]:
    count = data["breach_info"]["breach_count"]
    notify_user(f"Your email appeared in {count} known breaches. Consider resetting your password.")

import hashlib
import requests

HEADERS = {"Authorization": "Bearer YOUR_API_KEY", "Content-Type": "application/json"}

def password_is_safe(password: str) -> bool:
    sha1 = hashlib.sha1(password.encode()).hexdigest().upper()
    r = requests.post(
        "https://developer.encrata.com/api/lookup/email/password/breaches",
        headers=HEADERS, json={"sha1": sha1},
    )
    return not r.json()["found"]

if not password_is_safe(user_password):
    reject("That password has appeared in a data breach. Please choose another.")

#!/usr/bin/env bash
set -euo pipefail

result=$(curl -s -X POST "https://developer.encrata.com/api/lookup/breaches/github" \
  -H "Authorization: Bearer $ENCRATA_API_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"repo\": \"$GITHUB_REPO_URL\"}")

leaks=$(echo "$result" | jq '.result.summary.total')

if [ "$leaks" -gt 0 ]; then
  echo "$result" | jq -r '.result.findings[] | "\(.severity)\t\(.file):\(.start_line)\t\(.rule_id)"'
  echo "Found $leaks leaked secret(s). Failing the build."
  exit 1
fi