Leads

Preview email verification

Counts distinct emails that already have a fresh result and emails that would spend verifier credits. Fresh results are excluded before the suggestion. Verification still requires an explicit verify option on the later write.

POST/v1/email-verification/preview

Authorization

bearerAuth

AuthorizationBearer <token>

Use an account API key in the Authorization header: Authorization: Bearer f_....

In: header

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

emails?array<string>

campaign_id?string

Formatuuid

global_lead_ids?array<string>

allow_catch_all?boolean

curl -X POST "https://example.com/v1/email-verification/preview" \  -H "Content-Type: application/json" \  -d '{    "emails": [      "ada@example.com"    ],    "allow_catch_all": false  }'

{  "scope": "inline",  "total": 0,  "freshReused": 0,  "needsVerification": 0,  "candidates": 0,  "affordable": 0,  "credits_remaining": 0,  "current_remaining": 0,  "rollover_remaining": 0,  "rollover_expires_at": "2019-08-24T14:15:22Z",  "total_available": 0,  "excluded": {    "property1": 0,    "property2": 0  }}

{  "error": {    "type": "invalid_request_error",    "code": "invalid_flow",    "message": "Flow validation failed"  },  "details": [    {      "path": "nodes[1].data.variants[0].id",      "code": "invalid_variant_id",      "message": "Email variants must have a stable UUID id."    }  ]}

{  "error": {    "type": "authentication_error",    "code": "invalid_api_key",    "message": "A valid Furnace API key is required"  }}

{  "error": {    "type": "rate_limit_error",    "code": "rate_limit_exceeded",    "message": "Rate limit exceeded for this account"  }}

{  "error": {    "type": "api_error",    "code": "internal_error",    "message": "Internal server error"  }}