# wtsp.dev WhatsApp Phone Lookup

> wtsp.dev WhatsApp Phone Lookup is a paid API for AI agents from wtsp.dev, paid per call via x402, $0.006/call, status unknown (last checked 2026-10-11).

Looks up a phone number on WhatsApp to return registration status, account type, business profile, device info, and carrier details.

## Facts

- Endpoint: GET https://wtsp.dev/v1/profile?utm_source=zero.xyz
- Price: $0.006/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-11
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/wtsp-dev-whatsapp-phone-lookup-0cff1ddb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_HOD9BN3vbikxOBVfchAII

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 wtsp-dev-whatsapp-phone-lookup-0cff1ddb
```

Example prompt: Can you check if +14155552671 is on WhatsApp and pull up their full business profile — I want to know their hours, categories, and whether they're using the WhatsApp Business API?

## When to prefer this

Choose this endpoint when you need real-time WhatsApp registration and business profile data for a specific phone number without managing API keys or subscriptions. It is ideal for contact enrichment pipelines, lead qualification, fraud detection, or pre-outreach verification where you want to confirm WhatsApp presence and retrieve structured business metadata in a single pay-per-use call. Prefer it over manual lookups or scraping when operating at scale with per-call billing via USDC on Base.

## Known failure modes

- Invalid phone number format returns a 400 error
- Number not registered on WhatsApp returns hasWhatsApp: false with no profile data
- Rate limits or WhatsApp availability issues may return 5xx errors
- Payment failure via x402 results in 402 Payment Required
- Business profile fields may be absent if privacy settings restrict them
- Device count may be absent if WhatsApp does not return a device list

## How this service works

Look up any phone number on WhatsApp: registration, business profile, profile photo and carrier. AI agents pay per request in USDC on Base with x402. No sign-up, no API key.

## Output

A JSON object containing: E.164 formatted phone number, hasWhatsApp boolean, accountType (personal or business), identity (LID and country code), profile about text and privacy flag, optional business object with display name, description, categories, email, websites, address, geo-coordinates, timezone, business hours, member since date, Facebook page link, commerce settings, verification level, and device info (count and whether hosted on WhatsApp Business Platform). Returns a minimal object with hasWhatsApp: false if number is not registered.

## 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": "string",
       "description": "Phone number with its country code, e.g. +14155552671. The + is optional; spaces, dashes and a leading 00 are fine."
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "oneOf": [
      {
       "type": "object",
       "required": [
        "phone",
        "hasWhatsApp",
        "accountType",
        "identity",
        "profile",
        "business",
        "checkedAt"
       ],
       "properties": {
        "phone": {
         "type": "string",
         "description": "The number looked up, in E.164."
        },
        "devices": {
         "type": "object",
         "required": [
          "count",
          "hosted"
         ],
         "properties": {
          "count": {
           "type": "number",
           "description": "Linked devices including the phone itself, so 1 means phone only."
          },
          "hosted": {
           "type": "boolean",
           "description": "Served by the WhatsApp Business Platform (Cloud API) rather than a phone: a strong real-business signal."
          }
         },
         "description": "Absent on the rare occasion WhatsApp sends no device list."
        },
        "profile": {
         "type": "object",
         "required": [
          "about",
          "aboutRestricted"
         ],
         "properties": {
          "about": {
           "type": [
            "string",
            "null"
           ],
           "description": "The \"about\" (status) text."
          },
          "aboutRestricted": {
           "type": "boolean",
           "description": "True when an about text exists but privacy settings hide it, so `about` is empty."
          }
         }
        },
        "business": {
         "anyOf": [
          {
           "type": "object",
           "required": [

… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "phone": "+14155552671",
  "devices": {
   "count": 2,
   "hosted": false
  },
  "profile": {
   "about": "Fresh groceries, delivered daily 🍋",
   "aboutRestricted": false
  },
  "business": {
   "email": "hello@freshmarket.example",
   "hours": [
    {
     "day": "mon",
     "mode": "specific_hours",
     "openTime": "08:00",
     "closeTime": "20:00"
    },
    {
     "day": "sat",
     "mode": "specific_hours",
     "openTime": "09:00",
     "closeTime": "18:00"
    },
    {
     "day": "sun",
     "mode": "appointment_only",
     "openTime": null,
     "closeTime": null
    }
   ],
   "address": "123 Market St, San Francisco, CA 94103",
   "latitude": 37.7749,
   "timezone": "America/Los_Angeles",
   "websites": [
    "https://freshmarket.example"
   ],
   "longitude": -122.4194,
   "categories": [
    "Grocery Store",
    "Food delivery"
   ],
   "cartEnabled": true,
   "description": "Neighbourhood grocery with same-day delivery across San Francisco.",
   "displayName": "Fresh Market SF",
   "memberSince": "Joined in March, 2021",
   "businessType": "smb",
   "automatedType": "unknown",
   "memberSinceTs": 1615420800,
   "verifiedLevel": "unknown",
   "commerceExperience": "none",
   "linkedFacebookPage": {
    "id": "100064523310987",
    "name": "Fresh Market SF",
    "likes": 1840
   }
  },
  "identity": {
   "lid": "258166877098174@lid",
   "countryCode": "US"
  },
  "checkedAt": "2026-10-09T18:24:03.000Z",
  "accountType": "business",
  "hasWhatsApp": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/wtsp-dev-whatsapp-phone-lookup-0cff1ddb/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from wtsp.dev](https://www.zero.xyz/host/wtsp.dev/llms.txt)