Estimate a verification
How many of the target’s contacts were never verified and what verifying them would cost. Changes nothing.
/verifications/estimateAuthorizationToken Bearer · headerobligatorioA BillionSend API key (bs_…).
application/jsontargetVerificationTargetobligatorioMostrar propiedadesOcultar propiedades
kindstringobligatoriocontactscontact_idsstring<uuid>[]obligatorioContacts of the team, by id
kindstringobligatoriosegmentsegment_idstring<uuid>obligatorioEvery contact in this segment
kindstringobligatoriobroadcastbroadcast_idstring<uuid>obligatorioThe broadcast's audience: the contacts it would mail, leaving out everyone who unsubscribed
The counts and the estimated cost
objectstringobligatorioverification_estimatetotalintegerobligatorioContacts the target names
unverifiedintegerobligatorioOf them, never verified: what a start would verify (verified ones are skipped)
in_runintegerobligatorioOf the unverified, already being verified
grant_remainingintegerobligatorioFree verification credit left this quota month, which a run uses first
estimated_centsintegerobligatorioWhat verifying the unverified would cost past the credit, in cents
Missing, malformed, unknown or revoked API key
statusCodenumberobligatorionamestringobligatoriomessagestringobligatorioThe segment or broadcast is not one of the team's
statusCodenumberobligatorionamestringobligatoriomessagestringobligatorioValidation error
statusCodenumberobligatorionamestringobligatoriomessagestringobligatorioOver the rate limit (rate_limit_exceeded, with Retry-After)
statusCodenumberobligatorionamestringobligatoriomessagestringobligatorio