phone-verifications
Verify phone numbers in bulk via CSV upload or direct submission.
Start a phone verification batch (raw numbers)
Submits a batch of raw phone numbers or contacts (whichever is provided) to the OptimalDial validation provider, after filtering out non-US numbers and numbers already validated for this organization. Requires at least 100 new numbers after that filtering and a positive organization balance. Returns immediately with a `pending` job; the job resolves asynchronously via the `webhook` once the provider finishes, at which point `saveLeads` controls whether validated rows are imported as leads. For CSV files, use `uploadCsv` instead.
List phone verification jobs
Lists phone verification batches for the organization.
Get a phone verification job
Fetches a single phone verification batch by ID.
Start a phone verification batch (CSV upload)
Accepts a multipart CSV upload plus a `data` field (matching `PhoneVerificationCsvUploadSchema`) identifying which columns hold the phone number and name, then runs the same validation flow as `upload`. The original file is stored so results can later be merged back against it.
Download phone verification results
Streams back a CSV of one completed job's results, merged against the original uploaded file when there was one. `processed` includes every row; `processed-filtered` includes only validated/valid rows. Errors if the job has not finished (`status` must be `completed`).
Get a phone verification job's tier breakdown
Returns how a completed job's validated numbers break down across the provider's confidence/pricing tiers. Errors if the job has not finished.
Get pending phone verification totals
Returns the count of jobs and total phone numbers still `pending`/`processing` for the organization, for a lightweight progress indicator without listing every job.