jobs

Create a bulk job

Checks up to 50,000 numbers and e-mail addresses (JSON body, or a CSV upload as multipart/form-data). The maximum possible cost is reserved up front (bulk prices; real-time prices for parts too small for the bulk price, see POST /v1/jobs/estimate); cached, inconclusive, invalid and duplicate rows are released when the job finishes. Poll GET /v1/jobs/{id} (or subscribe to job.completed), then page through GET /v1/jobs/{id}/results or download the whole file. Test-key jobs complete immediately.

post/jobs

Request

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

Headers

Idempotency-Keystring

Any unique string (1–255 printable ASCII) for safe retries: a retry with the same key and body within 24 hours returns the stored response (header Idempotent-Replayed: true) instead of running the request again.

Request body

OR

Example request

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

Response

Job created. estimate shows how the list was counted.

object'job' required
idstring required
status'queued' | 'preflight' | 'running' | 'merging' | 'completed' | 'failed' | 'cancelled' required
livemodeboolean
checksstring[]
created_atstring date-time required
completed_atstring date-time nullable
eta_secondsinteger nullable
retention_daysinteger
metadataobject
purged_atstring date-time

Set when the results were deleted with DELETE /v1/jobs/{id}.

Changes

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