IPQS: Batch Phone Validate - Deepline

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 one call. Use ctx.tools.execute(...) inside a Play for durable calls, scheduled calls, or CSV processing.

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 lacks the details for a reliable example. Use deepline describe 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. 0.070 Deepline credits 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.