lookup

Check up to 100 numbers and e-mail addresses

Runs every requested check (see GET /v1/services) for every identifier of the check's input type: phone checks for numbers, e-mail checks for emails. Result rows come back in order: numbers first, then e-mails. The call waits up to wait seconds (default 10) for all answers; if some are still running it answers 202 with status: pending and a next.poll_url (or use a webhook). Checks without real-time support are refused with 403 service_disabled (param checks[i]) — send them in a bulk job. E-mail checks answer only whether an account or mailbox exists — never names, photos or profiles.

post/lookup

Request

  • Base URL: https://api.mobilevalidate.com/v1
  • URL: https://api.mobilevalidate.com/v1/lookup
  • 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

{
  "numbers": [
    "+447700900001"
  ],
  "emails": [
    "registered@test.mobilevalidate.com"
  ],
  "checks": [
    "whatsapp",
    "carrier"
  ]
}

Response

All checks completed.

object'lookup' required
idstring required
status'completed' | 'pending' required
livemodeboolean required
created_atstring date-time required
metadataobject
request_idstring required

Changes

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