# Phone Number Examples by Region and Type

> Phone Number Examples by Region and Type is a paid API for AI agents from phone-tools.x402tookit.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-11-02).

Returns example phone numbers for a given region and number type (fixed line, mobile, toll free, etc.) sourced from libphonenumber metadata.

## Facts

- Endpoint: GET https://phone-tools.x402tookit.com/phone-example?utm_source=zero.xyz
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-02
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/phone-number-examples-by-region-and-type-f937651d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_CGwxYyXUmzL6Sr6BJTcdU

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 phone-number-examples-by-region-and-type-f937651d
```

Example prompt: Can you give me some example phone numbers for Germany — I need samples for both mobile and fixed line types, formatted in E.164 and international formats?

## When to prefer this

Use this endpoint when you need authoritative, structured example phone numbers for a specific country or region and number type, especially for test data generation, UI placeholders, or format documentation — backed by Google's libphonenumber metadata rather than hand-crafted or made-up examples.

## Known failure modes

- Invalid or unsupported region code returns an error or empty examples array
- Unsupported number type for a given region returns no examples
- Missing required 'region' query parameter causes a validation error
- Network or payment (x402) failure prevents the response from being returned

## How this service works

Example phone numbers per region and type (fixed line, mobile, toll free, premium) taken from libphonenumber metadata.

## Output

Returns an array of example phone numbers for the requested region and type, each with E.164, international, national, and RFC3966 formats, plus the national number component, country code, metadata source, build date, and a summary/disclaimer about the data's origin from libphonenumber.

## 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": [
      "region"
     ],
     "properties": {
      "type": {
       "type": "string",
       "description": "fixed_line, mobile, toll_free, premium_rate, shared_cost, voip, personal_number, pager, uan, voicemail"
      },
      "region": {
       "type": "string",
       "description": "ISO region such as DE, or 001 for non-geographic"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "properties": {
      "asOf": {
       "type": [
        "null",
        "string"
       ]
      },
      "region": {
       "type": [
        "null",
        "string"
       ]
      },
      "source": {
       "type": [
        "null",
        "string"
       ]
      },
      "reasons": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "string"
       }
      },
      "summary": {
       "type": [
        "null",
        "string"
       ]
      },
      "verdict": {
       "type": [
        "null",
        "string"
       ]
      },
      "degraded": {
       "type": [
        "boolean",
        "null"
       ]
      },
      "examples": {
       "type": [
        "array",
        "null"
       ],
       "items": {
        "type": "object",
        "properties": {
         "e164": {
          "type": [
           "null",
           "string"
          ]
         },
         "type": {
          "type": [
           "null",
           "string"
          ]
         },
         "rfc3966": {
          "type": [
           "null",
           "string"
          ]
         },
         "national": {
          "type": [
           "null",
           "string"
          ]
         },
         "international": {
          "type": [
           "null",
           "string"
          ]
         },
         "nationalNumber": {
          "type": [
           "null",
           "string"
          ]
         }
        }
       }
      },

… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/phone-number-examples-by-region-and-type-f937651d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from phone-tools.x402tookit.com](https://www.zero.xyz/host/phone-tools.x402tookit.com/llms.txt)