# HubVibe Phone Number Validation & Lookup

> HubVibe Phone Number Validation & Lookup is a paid API for AI agents from hubvibe-io.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-10-01).

Validates and parses a phone number using Google's libphonenumber, returning validity, country, carrier, line type, time zones, and formatted representations without dialing or owner lookup.

## Facts

- Endpoint: POST https://hubvibe-io.com/work/phone/parse?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/hubvibe-phone-number-validation-lookup-4c063c6a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_jxMX_DYDmeQO8UN-vXiVG

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 hubvibe-phone-number-validation-lookup-4c063c6a -d '<json body>'
```

Example prompt: Can you validate the phone number +14155552671 and tell me whether it's a mobile or landline, which carrier the range was originally issued to, what country it belongs to, and give me the E.164 and international formats?

## When to prefer this

Choose this endpoint when you need to validate, parse, or classify a phone number without making a live network query or revealing subscriber identity. It is ideal for form validation, fraud screening (detecting VoIP/premium numbers), formatting numbers for SMS or CRM systems, and enriching user records with country, carrier, and line-type metadata. Prefer it over live HLR lookup services when privacy or cost is a concern and real-time portability data is not required.

## Known failure modes

- Invalid or unparseable number string returns a not-valid result with no carrier or type data
- Missing region code for a national-format number (without country prefix) may cause incorrect parsing or invalid result
- Unsupported region code returns an error or invalid parse
- Number within valid format but unassigned range returns valid structure but indeterminate carrier
- Network or service errors return HTTP error codes

## How this service works

Phone number validation and lookup: valid or not, country and area, the carrier the range was issued to, line type (mobile, landline, toll-free, VoIP, premium), time zones and E.164, international and national formats, from Google's libphonenumber numbering plans. Nothing is dialled and the owner is never looked up. Input: number; optional region for a national-format number.

## Output

Returns whether the phone number is valid, the country and area it belongs to, the carrier the number range was issued to, the line type (mobile, landline, toll-free, VoIP, or premium), associated time zones, and the number formatted in E.164, international, and national formats. Does not dial the number or reveal the subscriber's identity.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "number": {
   "type": "string",
   "maxLength": 40,
   "minLength": 3
  },
  "region": {
   "type": "string",
   "pattern": "^[A-Za-z]{2}$"
  },
  "language": {
   "type": "string",
   "pattern": "^[A-Za-z]{2,3}(-[A-Za-z0-9]{2,8})*$",
   "maxLength": 35
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "result": {
   "e164": "+442070313000",
   "input": {
    "number": "+44 20 7031 3000",
    "region": "GB"
   },
   "notes": [],
   "valid": true,
   "region": "GB",
   "carrier": "T-Mobile",
   "country": "United Kingdom",
   "location": "London",
   "national": "020 7031 3000",
   "possible": true,
   "line_type": "fixed_line",
   "checked_at": "2026-09-26T18:00:00Z",
   "time_zones": [
    "Europe/London"
   ],
   "country_code": 44,
   "international": "+44 20 7031 3000",
   "metadata_version": "9.0.40"
  },
  "status": "ok",
  "worker": "phone.parse",
  "price_usd": 0.02,
  "provenance": {
   "steps": [
    {
     "ms": 312,
     "ok": true,
     "step": "quote",
     "reason": "provider_timeout",
     "provider": "coinbase-advanced-trade-public"
    }
   ],
   "attempts": 1,
   "elapsed_ms": 340,
   "providers_used": [
    "coinbase-advanced-trade-public"
   ]
  },
  "receipt_id": "rcpt_9f1c2b3a4d5e6f70",
  "attribution": [
   {
    "url": "https://translate.google.com",
    "text": "Translated by Google"
   }
  ],
  "receipt_url": "/work/receipts/rcpt_9f1c2b3a4d5e6f70"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/hubvibe-phone-number-validation-lookup-4c063c6a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from hubvibe-io.com](https://www.zero.xyz/host/hubvibe-io.com/llms.txt)