# Contact Verify – Phone Line-Type Lookup

> Contact Verify – Phone Line-Type Lookup is a paid API for AI agents from verify-x402.okwithit9.workers.dev, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-22).

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.

## Facts

- Endpoint: POST https://verify-x402.okwithit9.workers.dev/verify/phone?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-22
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/contact-verify-phone-line-type-lookup-dfb117ab
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_RXOhMgcRPKwR4qgwuH_if

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability contact-verify-phone-line-type-lookup-dfb117ab -d '<json body>'
```

Example prompt: Can you check if +14155552671 is a mobile, landline, or VoIP number and tell me which carrier it belongs to?

## When to prefer this

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.

## Known failure modes

- 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

## How this service works

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.

## Output

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).

## Request schema (JSON Schema)

```json
{
 "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"
      }
     }
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "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"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/contact-verify-phone-line-type-lookup-dfb117ab/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from verify-x402.okwithit9.workers.dev](https://www.zero.xyz/host/verify-x402.okwithit9.workers.dev/llms.txt)