IPQS: Batch Phone Validate

Screen up to 100 known phone numbers for fraud and DNC risk after primary phone validation.

Tool ID: ipqs_batch_phone_validate

Run this action

Use the TypeScript SDK for a single call. Put ctx.tools.execute(...) inside a Play when the call should be durable, scheduled, or run across a CSV.

import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'ipqs_batch_phone_validate',
  {
    "phone_batch": [
      {
        "phone": "+14155550123"
      }
    ]
  },
);

console.log(result.toolResponse.raw);

CLI

deepline tools execute ipqs_batch_phone_validate --input '{
  "phone_batch": [
    {
      "phone": "+14155550123"
    }
  ]
}' --json

Example response

The static output schema is not detailed enough to generate a reliable example. Use deepline tools get ipqs_batch_phone_validate --json for the complete live contract.

Input reference

Validate up to 100 phone numbers in one synthetic batch. Deepline runs at most 5 IPQS checks concurrently, so larger batches can be slow. 1 credit per phone.

Name	Type	Required	Default	Details
`payload.phone_batch`	`array`	Yes	—	Array of phone objects to validate in batch (1-100). Deepline runs at most 5 IPQS checks concurrently, so larger batches can be slow. Minimum items: 1. Maximum items: 100.
`payload.country`	`array`	No	—	ISO-3166 country codes to bias lookup (e.g. [“US”,“CA”]).
`payload.strictness`	`0 \| 1 \| 2`	No	—	Strictness level 0-2. Higher = more false positives but catches more fraud.

Output reference

Name	Type	Required	Default	Details
`result.status`	`string`	Yes	—	—
`result.result`	`object`	Yes	—	—
`result.result.data`	`object`	Yes	—	—
`result.result.data.phone_batch`	`array`	Yes	—	—
`result.result.data.phone_batch[].valid`	`boolean`	Yes	—	—
`result.result.data.phone_batch[].line_type`	`string`	Yes	—	—
`result.result.data.phone_batch[].carrier`	`string`	Yes	—	—

Deepline cost

Pricing model: per_result (per result).
Estimated Deepline credits: 0.07 per pricing unit.

Get started

Build and automate

Common workflows

Data and integrations

Reference

IPQS: Batch Phone Validate

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

​Run this action

​CLI

​Example response

​Input reference

​Output reference

​Deepline cost

​Related documentation

Run this action

CLI

Example response

Input reference

Output reference

Deepline cost

Related documentation