{ "openapi": "3.0.1", "info": { "title": "Phone Validator, Carrier & TCPA Litigator Lookup (US, Canada)", "description": "Live US & Canada carrier lookup — not just a format check, and no API key to bring. Get the carrier a number uses today (not when it was issued), line type, deliverability, ported status, TCPA litigator scrub, free state-DNC scrub, landline-SMS routing, IP↔phone geo. No start fee.", "version": "0.1", "x-build-id": "62Fpe5nXeuDYdfIxj" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/checkthatphone~phone-validator/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-checkthatphone-phone-validator", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/checkthatphone~phone-validator/runs": { "post": { "operationId": "runs-sync-checkthatphone-phone-validator", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/checkthatphone~phone-validator/run-sync": { "post": { "operationId": "run-sync-checkthatphone-phone-validator", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "required": [ "phoneNumbers" ], "properties": { "phoneNumbers": { "title": "Phone numbers", "type": "array", "description": "US & Canada phone numbers to verify, one per line. Any format works (E.164, national, dashes, parentheses). Most lines are just a phone number. Optionally, to also get IP↔phone geolocation (ipResult + country/state/city/metro/timezone — included with the lookup, not a separate add-on), append an IP after a comma on that line only: `phone,ip` (IPv4 or IPv6) — see the last two prefilled lines. The IP is optional and per-line; leave it off and geolocation falls back to the number's area code. Duplicates are removed automatically (one lookup per unique number, or phone+IP pair). Billed per credit, not per result — one number can be 1–3 credits: litigator scrub adds +1 per number, landline-SMS adds +1 only on landlines (mobiles aren't surcharged). Free Apify accounts are limited by their Apify prepaid balance (~$5/mo of platform credit); paid plans have no balance limit.", "items": { "type": "string" } }, "litigatorFilter": { "title": "TCPA litigator scrub — +1 credit per number", "type": "boolean", "description": "Adds 1 credit per number — every number is screened. Flag known TCPA serial plaintiffs / professional litigators. Screened against industry-leading litigation data — the same caliber the largest TCPA-compliance platforms rely on — built from federal & state court records and demand-letter activity, refreshed daily.", "default": true }, "landlineSmsLookup": { "title": "Landline SMS lookup — +1 credit per landline", "type": "boolean", "description": "Detect text-enabled landlines (SMS-to-landline routing): messaging provider, country, and whether the landline can receive texts. Off by default — it adds 1 credit per landline (mobiles are never surcharged), so turn it on when you plan to text landlines.", "default": false }, "dncOther": { "title": "State DNC & complainers scrub — free", "type": "boolean", "description": "Free — adds no cost. Screens each number against state do-not-call registries (40 states, refreshed weekly) and a national list of ~700k numbers with documented DNC/TCPA complaint history. Returns dncStateResult, dncComplainerResult, and dncStateCovered — the coverage flag marks the 11 states without registry data (FL, CO, IN, MA, MO, PA, TX, WY, LA, OK, TN), so an unchecked state never reads as clear. The federal DNC registry is not included — scrub it separately.", "default": true } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }