jobs

Estimate a bulk job for free

Validates and counts a list without storing it, calling a data source or charging: valid, invalid and duplicate rows, cached answers, the maximum possible cost (max_cost) and its breakdown per check and unit price. Checks in parts too small for the bulk price (WhatsApp: fewer than 132 numbers from one country in the job) are priced at the real-time price and listed with reason: small_batch. Bulk-only checks bill each country of the job at least minimum_checks × the bulk price when it returns an answer; countries with fewer numbers are listed with reason: country_minimum and their minimum is included in max_cost. Same body as POST /v1/jobs.

post/jobs/estimate

Request

  • Base URL: https://api.mobilevalidate.com/v1
  • URL: https://api.mobilevalidate.com/v1/jobs/estimate
  • Auth: HTTP bearer

Request body

OR

Example request

{
  "checks": [
    "whatsapp",
    "carrier"
  ]
}

Response

The estimate.

object'estimate'
totalinteger
validinteger
invalidinteger
duplicateinteger
unsupportedinteger
suppressedinteger
checksstring[]
checks_totalinteger

Σ rows × checks of the row's input type

cachedinteger

Checks (row × check) with a fresh answer in your account's cache now; free if still fresh when the job runs.

billable_maxinteger

Checks (row × check) that may be billed, worst case (includes cached).

Changes

No recorded changes to this operation across all 1 revision of this API.