npm install @checkharbor/node

import { Checkharbor, CheckharborError } from "@checkharbor/node";

const checkharbor = new Checkharbor({
  apiKey: process.env.CHECKHARBOR_API_KEY!,
  // baseUrl: "http://localhost:4000", // override for local dev
});

// Email
const email = await checkharbor.validateEmail("john@example.com");

// Phone
const phone = await checkharbor.validatePhone("+905321234567", {
  countryHint: "TR",
  hlr: true,
});

// IP
const ip = await checkharbor.ipIntel("84.17.45.10");

// Unified fraud check
const fraud = await checkharbor.verify({
  email: "john@example.com",
  ip: "84.17.45.10",
});

// Batch
const job = await checkharbor.batch.create({
  type: "email",
  rows: ["a@example.com", "b@example.com"],
});
const done = await checkharbor.batch.waitUntilDone(job.id);
const csv = await checkharbor.batch.downloadResult(done);

// Error handling
try {
  await checkharbor.validateEmail("x@y.com");
} catch (e) {
  if (e instanceof CheckharborError) {
    console.log(e.code, e.status); // "insufficient_credits" 402
  }
}

npm login
npm publish --access public

pip install checkharbor

from checkharbor import Checkharbor, CheckharborError
import os

client = Checkharbor(api_key=os.environ["CHECKHARBOR_API_KEY"])

# Email
email = client.validate_email("john@example.com")

# Phone
phone = client.validate_phone("+905321234567", country_hint="TR", hlr=True)

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

# Unified
fraud = client.verify(email="john@example.com", ip="84.17.45.10")

# Batch
job = client.batch.create(type="email", rows=["a@example.com", "b@example.com"])
done = client.batch.wait_until_done(job["id"])
csv_content = client.batch.download_result(done)

# Error handling
try:
    result = client.validate_email("x@y.com")
except CheckharborError as e:
    print(e.code, e.status)  # insufficient_credits 402

pip install build twine
python -m build
twine upload dist/*

cd sdk/n8n-nodes-checkharbor
npm login
npm publish --access public