Kickbox: Verify Email

Verify an email address with Kickbox for deliverability, disposable and catch-all detection.

Tool ID: kickbox_verify_email

Run this action

Use the TypeScript SDK for one call. Use ctx.tools.execute(...) inside a Play for durable calls, scheduled calls, or CSV processing.

import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'kickbox_verify_email',
  {
    "email": "jane.doe@example.com"
  },
);

console.log(result.toolResponse.raw);

CLI

deepline tools execute kickbox_verify_email --input '{
  "email": "jane.doe@example.com"
}' --json

Example response

The SDK returns this shape at result.toolResponse.raw. The example values illustrate the response.

{
  "data": {
    "result": "deliverable",
    "reason": "example",
    "role": true
  }
}

Use deepline describe kickbox_verify_email --json for the latest machine-readable contract.

Input reference

Verify one email address supplied in email. Returns deliverable, undeliverable, risky or unknown, Sendex quality score, disposable and accept-all flags, and any typo suggestion. Uses the connected Kickbox account verification credits. unknown results are refunded by Kickbox. Supports standard US accounts. EU-only accounts require the EU API and are not supported by this integration.

Name	Type	Required	Default	Details
`payload.email`	`string`	Yes	—	The email address to verify. Format: `email`.
`payload.timeout`	`integer`	No	`6000`	Verification timeout in milliseconds. Maximum: 30000.

Output reference

Standard tool result payload.

Name	Type	Required	Default	Details
`result.data`	`object`	Yes	—	Provider response payload.
`result.data.result`	`"deliverable" \| "undeliverable" \| "risky" \| "unknown"`	No	—	Allowed: `deliverable`, `undeliverable`, `risky`, `unknown`.
`result.data.reason`	`string`	No	—	Reason code such as accepted_email, rejected_email, invalid_smtp, etc.
`result.data.role`	`boolean`	No	—	—
`result.data.free`	`boolean`	No	—	—
`result.data.disposable`	`boolean`	No	—	—
`result.data.accept_all`	`boolean`	No	—	—
`result.data.did_you_mean`	`string \| null`	No	—	—
`result.data.sendex`	`number`	No	—	Minimum: 0. Maximum: 1.
`result.data.email`	`string`	No	—	—
`result.data.user`	`string`	No	—	—
`result.data.domain`	`string`	No	—	—
`result.data.success`	`boolean`	No	—	—
`result.data.message`	`string \| null`	No	—	—
`result.meta`	`object`	No	—	Additional response metadata (status, paging).

Deepline cost

Pricing model: per_result (per result).
Estimated Deepline credits: 0.06 per pricing unit.

​Run this action

​CLI

​Example response

​Input reference

​Output reference

​Deepline cost

​Related documentation

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

Related documentation