Start a verification
Starts deep verification of the target’s contacts, one run per 50,000 of them. Contacts verified before are skipped unless recheck is true, and a contact already being verified never joins a second run. Paid plans only; billed per verified address on the monthly invoice.
/verificationsAuthorizationBearer 令牌 · header必填A BillionSend API key (bs_…).
application/jsontargetVerificationTarget必填显示属性隐藏属性
kindstring必填contactscontact_idsstring<uuid>[]必填Contacts of the team, by id
kindstring必填segmentsegment_idstring<uuid>必填Every contact in this segment
kindstring必填broadcastbroadcast_idstring<uuid>必填The broadcast's audience: the contacts it would mail, leaving out everyone who unsubscribed
recheckbooleanVerify contacts verified before too; by default they are skipped
The runs started
objectstring必填verification_startrunsobject[]必填The runs started, one per 50,000 contacts
显示属性隐藏属性
object 数组idstring<uuid>必填totalinteger必填contactsinteger必填Contacts that joined a run
already_verifiedinteger必填Contacts skipped because they were verified before (pass recheck to include them)
in_runinteger必填Contacts skipped because a run already holds them
Missing, malformed, unknown or revoked API key
statusCodenumber必填namestring必填messagestring必填The team is on the Free plan (plan_limit_reached)
statusCodenumber必填namestring必填messagestring必填The segment or broadcast is not one of the team's
statusCodenumber必填namestring必填messagestring必填Nothing left to verify, too many contacts at once, or a validation error
statusCodenumber必填namestring必填messagestring必填Over the rate limit (rate_limit_exceeded, with Retry-After)
statusCodenumber必填namestring必填messagestring必填Deep verification is not available right now
statusCodenumber必填namestring必填messagestring必填