# wtsp.dev Carrier Lookup

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

Look up carrier, line type, country, and location details for any phone number

## Facts

- Endpoint: GET https://wtsp.dev/v1/carrier?utm_source=zero.xyz
- Price: $0.004/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-carrier-lookup-7fd25ecb
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_GLK6rzQY8QVCGdtMNiHKz

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-carrier-lookup-7fd25ecb
```

Example prompt: Can you look up the carrier and line type for the phone number +447400123456?

## When to prefer this

Choose this endpoint when you need lightweight, no-signup carrier and line-type intelligence for any phone number globally, billed per-request via USDC on Base. Ideal for agents that need to enrich contact data, pre-screen signups for VoIP fraud, or validate SMS routing without committing to a subscription-based telecom API.

## Known failure modes

- Invalid or unrecognizable phone number format returns an error
- Numbers from countries with no carrier data may return null fields
- Ported numbers return original carrier, not current carrier
- Rate limiting or payment failure via x402 protocol returns 402 Payment Required
- Premium or short code numbers may not resolve cleanly

## 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 the phone number in E.164 format, carrier name (original carrier for ported numbers), ISO 3166-1 alpha-2 country code, country name, flag emoji, line type (mobile/fixed line/VoIP/toll-free etc.), isMobile boolean, location (town or region if published), timezones array, national format, international format, and country calling code.

## 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",
     "required": [
      "phone",
      "carrier",
      "lineType",
      "isMobile",
      "country",
      "countryName",
      "flag",
      "countryCallingCode",
      "location",
      "timezones",
      "international",
      "national"
     ],
     "properties": {
      "flag": {
       "type": "string"
      },
      "phone": {
       "type": "string",
       "description": "The number looked up, in E.164."
      },
      "carrier": {
       "type": "string",
       "description": "The number's carrier. For a ported number, its original carrier."
      },
      "country": {
       "type": "string",
       "description": "ISO 3166-1 alpha-2 country of the number."
      },
      "isMobile": {
       "type": [
        "boolean",
        "null"
       ],
       "description": "Null where a country hands mobiles and landlines out of one shared range."
      },
      "lineType": {
       "type": "string",
       "description": "`mobile`, `fixed line`, `fixed line or mobile`, `voip`, `toll free`…"
      },
      "location": {
       "type": [
        "string",
        "null"
       ],
       "description": "Town or region the number was issued in, where published."
      },
      "national": {
       "type": "string",
       "description": "The number as dialled inside its country."
      },
      "timezones": {
       "type": "array",
       "items": {
        "type": "string"
       }
      },
      "countryName": {
       "type": "string"
      },
      "international": {
       "type": "string",
       "description": "The number in international format."
      },
      
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "flag": "🇬🇧",
  "phone": "+447400123456",
  "carrier": "Three",
  "country": "GB",
  "isMobile": true,
  "lineType": "mobile",
  "location": null,
  "national": "07400 123456",
  "timezones": [
   "Europe/London"
  ],
  "countryName": "United Kingdom",
  "international": "+44 7400 123456",
  "countryCallingCode": "+44"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/wtsp-dev-carrier-lookup-7fd25ecb/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)