@skink/sdk — Node.js

Official server-side client for the skink email verification API.

⚠️ Server-side only — never use this in a browser

Your API key is a secret credential, same as a database password. This client throws if it detects a browser environment, but that's a backstop, not the plan — never ship your key in frontend JavaScript, a mobile app bundle, or any code a user's device can inspect. Anyone who reads it can spend your credits and see verification activity on your account. Load it from a server-side environment variable and call skink from your own backend; have your frontend call your backend, not skink directly.

If a key is ever exposed, revoke it immediately from the dashboard (/keys) and issue a new one.

Install

Copy this directory into your project, or npm install it once published. Requires Node 18+ (uses the built-in fetch).

Usage

import { SkinkClient } from "@skink/sdk";

const skink = new SkinkClient(process.env.SKINK_API_KEY);

const result = await skink.verify("[email protected]");
console.log(result.status, result.confidence, result.signals.reasons);

const job = await skink.bulkCreate({ emails: ["[email protected]", "[email protected]"] });
const status = await skink.bulkStatus(job.job_id);

API

• new SkinkClient(apiKey, { baseUrl?, timeoutMs? })
• verify(email, { timeoutMs?, idempotencyKey? })
• uploadFile(csvBufferOrString) → { file_id }
• bulkCreate({ emails? , fileId? }, callbackUrl?)
• bulkList()
• bulkStatus(jobId)
• bulkResults(jobId)
• reportBounce(email, outcome, { verifiedAt? })

All methods throw SkinkError (.status, .code, .message) on a non-2xx response.