Create Async Task for several phone numbers

Submit a batch of phone numbers for an asynchronous HLR or Validate lookup. Each number in keys can carry a uid that is echoed back with its result. The response returns the task_id plus the estimated cost and valid / invalid / duplicate counts; poll /result/{job_id} or /metadata/{job_id} with it, or set respond_url to receive a webhook when the task completes.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
enum
required
Allowed:
Body Params

Payload to submit a batch of numbers for async lookup.

keys
array of objects
required
Keys*

Endpoint that will receive the result callback when the task completes.

RespondMethodEnum | null

HTTP method to use for the webhook (post = form-encoded, post_json = JSON body).

RespondFormatEnum | null

Payload shape for the webhook: metadata (task summary only) or metadata_with_results (summary + per-number results).

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json