Phone Enrichment

Find mobile numbers in bulk

Find up to 100 mobile numbers in one call. Returns a task id straight away; results arrive later.

• Supply webhook_url and the results are POSTed there when the batch finishes. • Or poll GET /phone/find/bulk?job_id=<task_id> whenever you like.

10 credits per number found. Send an Idempotency-Key header to make retries safe for 24h.

post/api/v1/phone/find/bulk

Request

  • Base URL: https://api.scalelist.com
  • URL: https://api.scalelist.com/api/v1/phone/find/bulk
  • Auth: API key in header x-api-key

Headers

idempotency-keystring

Optional. Per-submission UUID (recommended) so client-side retries on network blips don't create duplicate tasks or extra charges. Replay window: 24h.

Request body

webhook_urlstring uri

Optional destination URL for the completion callback. When omitted, poll GET /phone/find/bulk?job_id=... for results.

Response

Task accepted (or idempotent replay of an earlier submission).

taskIdstring

Mongo ObjectId of the durable search task.

status'queued'
totalinteger

Number of lead requests queued.

Changes

No recorded changes to this operation across all 2 revisions of this API.