# Tenjin Phone Lookup

> Tenjin Phone Lookup is a paid API for AI agents from tenjin.blog, paid per call via x402, $1/call, status unknown (last checked 2026-09-13).

Looks up US phone number intelligence — either full CNAM caller name plus carrier data, or carrier-only details (line type, mobile network, rate-center) — with charges only on successful results.

## Facts

- Endpoint: POST https://tenjin.blog/api/phone-lookup
- Price: $1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tenjin-phone-lookup-bbdd01e8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_VJBLJjTohavCQt1ky1A6f

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 tenjin-phone-lookup-bbdd01e8 -d '<json body>'
```

Example prompt: Can you look up the caller name and carrier info for the US phone number +12025550187? Use the full 'name' product so I get the CNAM caller ID as well as the carrier and line type.

## When to prefer this

Choose this endpoint when you need to enrich a US phone number with caller ID (CNAM) or carrier metadata, especially when cost efficiency matters — you pay only for successful lookups. Prefer the 'carrier' product when you only need line type, carrier, and rate-center (cheaper). Use the 'name' product when caller identification is critical. Better than general-purpose telco APIs when you want pay-per-result pricing with no charge for misses.

## Known failure modes

- Invalid E.164 number format — no charge, empty result returned
- Number not found in CNAM database — no charge for 'name' product
- Non-US number submitted — likely no result or unsupported
- Missing product parameter — request may fail or default unexpectedly
- Network timeout — transient failure, retry recommended

## How this service works

Phone intelligence for an E.164 number, in two products the caller picks between: "name" returns the US CNAM caller name plus the carrier data, and the cheaper "carrier" returns the carrier, line type, mobile network and rate-center location alone. You are charged only on a result: no name found, or an invalid number, costs nothing. Agent guide: https://tenjin.blog/llms.txt

## Output

For the 'name' product: CNAM caller name (up to 15 characters), carrier name, line type (mobile/landline/VoIP), mobile network code, and rate-center location. For the 'carrier' product: carrier name, line type, mobile network code, and rate-center location — without the CNAM name. Returns nothing (and no charge) if the number is invalid or no result is found.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "product": {
   "enum": [
    "name",
    "carrier"
   ],
   "type": "string",
   "default": "name",
   "description": "Which product to buy. \"name\" (the default) returns the CNAM caller name plus the carrier data and is charged only when a name is found. \"carrier\" is cheaper, omits the name entirely, and is charged only when the number is valid. Caller names exist for US numbers only, so a non-US number should buy \"carrier\"."
  },
  "phoneNumber": {
   "type": "string",
   "pattern": "^\\+[1-9][0-9]{7,14}$",
   "description": "The phone number to identify, in E.164 form: a leading + followed by 8 to 15 digits (for example \"+13129457420\")."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "valid": true,
  "carrier": "the carrier that holds the number",
  "product": "name",
  "lineType": "mobile",
  "location": {
   "city": "the rate-center city",
   "state": "the rate-center state"
  },
  "callerName": "the name on record for the number you asked about",
  "countryCode": "US",
  "phoneNumber": "+10000000000",
  "mobileNetwork": {
   "mcc": "000",
   "mnc": "000"
  },
  "portedCarrier": "the underlying carrier when the number has been ported",
  "nationalFormat": "(000) 000-0000"
 }
}
```

## More

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