{"uid":"cap_RXOhMgcRPKwR4qgwuH_if","slug":"contact-verify-phone-line-type-lookup-dfb117ab","name":"Contact Verify – Phone Line-Type Lookup","description":"Pay-per-call email and phone verification for AI agents. Real mailbox-level email verification (SMTP-level deliverability, catch-all, disposable, and role detection). Live carrier line-type lookup (mobile, landline, VoIP, toll-free) with E.164 normalization. No signup and no API key. Payment is USDC on Base via x402 exact. Email addresses and phone numbers are not stored. Paid routes return HTTP 402 until the client sends a valid x402 PAYMENT-SIGNATURE. USDC uses 6 decimals.","url":"https://verify-x402.okwithit9.workers.dev/verify/phone?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["phone"],"properties":{"phone":{"type":"object","required":["type","description","required","example"],"properties":{"type":{"const":"string"},"example":{"type":"string"},"required":{"const":true},"description":{"type":"string"}},"description":"Phone number to look up. E.164, or a national number when country is set.","additionalProperties":false},"country":{"type":"object","required":["type","description","required","example"],"properties":{"type":{"const":"string"},"example":{"type":"string"},"required":{"const":false},"description":{"type":"string"}},"description":"ISO 3166-1 alpha-2; needed only when phone isn't E.164","additionalProperties":false}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"valid":{"type":"boolean"},"line_type":{"type":"object","properties":{"type":{"type":"string"},"error_code":{},"carrier_name":{"type":"string"},"mobile_country_code":{"type":"string"},"mobile_network_code":{"type":"string"}},"description":"Carrier line type: mobile, landline, VoIP, or toll-free."},"country_code":{"type":"string"},"phone_number":{"type":"string"}}}}}}},"responseSchema":{"type":"json","example":{"valid":true,"line_type":{"type":"mobile","error_code":null,"carrier_name":"Example Carrier","mobile_country_code":"310","mobile_network_code":"260"},"country_code":"US","phone_number":"+14155552671","national_format":"(415) 555-2671","calling_country_code":"1"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_DkM07qZTS_XABLcPVBPXq","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Performs a live carrier lookup to determine if a phone number is mobile, landline, VoIP, or toll-free, with E.164 normalization and carrier metadata.","exampleAgentPrompt":"Can you check if +14155552671 is a mobile, landline, or VoIP number and tell me which carrier it belongs to?","exampleUseCases":[{"title":"SMS deliverability pre-check","prompt":"Before we send that marketing SMS blast, check if the number +447911123456 is actually a mobile line or if it's a landline — I don't want to waste sends."},{"title":"Fraud detection for new signups","prompt":"A user just signed up with the phone number 2125551234 in the US — can you tell me if it's a real mobile line or a VoIP number? I want to flag suspicious registrations."},{"title":"Normalize and classify international number","prompt":"I have a UK phone number — 07700900123 — can you convert it to E.164 format and tell me whether it's mobile, landline, or toll-free, and which carrier it's on?"}],"resultDescription":"Returns a JSON object containing: a boolean validity flag, the E.164 normalized phone number, national format, calling country code, ISO country code, and a line_type object with the line category (mobile/landline/VoIP/toll-free), carrier name, mobile country code (MCC), and mobile network code (MNC).","failureModes":["Invalid or unrecognized phone number returns valid:false with no carrier data","Missing country parameter when a non-E.164 national number is provided may cause parse failure","Carrier lookup may return null carrier_name for unallocated or very new numbers","Rate limiting or payment failure (402) if USDC balance is insufficient","Malformed phone string (letters, special chars) may return an error response"],"whenToPreferThis":"Choose this endpoint when you need live, real-time carrier line-type data (mobile vs landline vs VoIP vs toll-free) with E.164 normalization in a single call. Ideal for fraud detection pipelines, SMS deliverability pre-screening, and contact data enrichment where knowing the line type and carrier is essential. Prefer this over static database lookups when accuracy and recency matter, and when you also need proper phone number formatting as a side benefit.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-22T06:31:35.751Z","isFirstParty":false,"canonicalSlug":"contact-verify-phone-line-type-lookup-dfb117ab"}