{"slug":"x402-agent-tools-nerolabs-workers-dev-phone-check-0c7162","title":"Checks up to 100 phone numbers from any country","host":"x402-agent-tools.nerolabs.workers.dev","method":"POST","resource":"https://x402-agent-tools.nerolabs.workers.dev/phone-check","category":"code","description":"Checks up to 100 phone numbers from any country: valid or not, the number in international E.164 format (+441174960012) and national format, country, and line type (mobile, landline, toll free, VoIP) from Google's libphonenumber data. Set defaultRegion (GB, US...) for numbers written without a count","price_listed":0.006,"price_asked":0.006,"state":"answering","state_label":"Answering","checks_7d":1,"answered_7d":1,"latency_ms_median":30,"reported_calls_30d":0,"reported_payers_30d":0,"networks":["eip155:8453"],"badge":"unverified","paid_checks_7d":0,"paid_ok_7d":0,"example_input":{"body":{"defaultRegion":"GB","phones":["0117 496 0012","+1 (415) 555-0132","12345"]},"bodyType":"json","method":"POST","type":"http"},"output_schema":{"$schema":"https://json-schema.org/draft/2020-12/schema","properties":{"input":{"additionalProperties":false,"properties":{"body":{"additionalProperties":false,"properties":{"defaultRegion":{"description":"Two-letter ISO country code assumed for numbers written without a country code, for example GB, US, AU, DE. Numbers starting with + are unaffected.","type":"string"},"flagNonPersonal":{"description":"Default true: toll free, shared cost, UAN, pager and voicemail numbers come back risky.","type":"boolean"},"flagPremiumRate":{"description":"Default true: premium-rate numbers come back risky rather than valid.","type":"boolean"},"flagVoip":{"description":"Default true: VoIP numbers come back risky.","type":"boolean"},"keep":{"description":"Which rows to return. all (default), valid, valid_and_risky, problems, or mobile (confirmed mobiles only, for SMS). The summary still counts every number.","enum":["all","valid","valid_and_risky","problems","mobile"],"type":"string"},"markDuplicates":{"description":"Default true: later repeats of the same E.164 number in this call come back duplicate.","type":"boolean"},"phoneField":{"description":"Rows only. The field holding the number, for example \"phone\" or \"contact_number\". Leave out to detect it automatically.","type":"string"},"phones":{"description":"A plain list of phone numbers in any format, for example [\"+44 20 7946 0123\", \"07825 123456\", \"(212) 555-0123\"]. Bare numbers such as 2079460123 are also accepted. Use this OR rows.","items":{"type":"string"},"type":"array"},"rows":{"description":"JSON objects that each hold a phone number in one field. Every original field comes back untouched with the verdict fields added. Use this OR phones.","items":{"type":"object"},"type":"array"}},"type":"object"},"bodyType":{"enum":["json","form-data","text"],"type":"string"},"method":{"enum":["POST"],"type":"string"},"type":{"const":"http","type":"string"}},"required":["type","method","bodyType","body"],"type":"object"},"output":{"properties":{"example":{"type":"object"},"type":{"type":"string"}},"required":["type"],"type":"object"}},"required":["input"],"type":"object"},"history":[{"day":"2026-10-21","reachable":true,"status":402,"valid_402":true,"asked_usdc":0.006,"price_match":true,"latency_ms":30,"error":null}],"description_full":"Checks up to 100 phone numbers from any country: valid or not, the number in international E.164 format (+441174960012) and national format, country, and line type (mobile, landline, toll free, VoIP) from Google's libphonenumber data. Set defaultRegion (GB, US...) for numbers written without a country code. Does not call the number. $0.002 per number, $0.002 minimum. Same engine as nerolabs/phone-number-validator.","last_updated":"2026-10-21T14:15:21.926Z","schemes":["exact"]}