# Tenjin Phone Lookup

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

Looks up a phone number to return the caller name (CNAM), carrier, line type, location, and porting information in E.164 format.

## Facts

- Endpoint: POST https://tenjin.sh/api/phone-lookup?utm_source=zero.xyz
- Price: $1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tenjin-phone-lookup-867638c9
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_JfeOfe0ZdRBo3V46JfW13

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-867638c9 -d '<json body>'
```

Example prompt: Can you look up the caller name and carrier for the phone number +13129457420?

## When to prefer this

Choose this endpoint when you need real-time phone number intelligence including caller name (CNAM), carrier, line type, and porting status, especially within an agent workflow that already uses x402 micropayment infrastructure. It is particularly well-suited when you need CNAM data for US numbers or carrier validation for international numbers, and when per-call pay-as-you-go pricing ($1 USDC) is preferable to a subscription. Use the 'carrier' product for non-US numbers or when caller name is not needed.

## Known failure modes

- Number not in E.164 format returns a validation error
- Non-US number with 'name' product returns no caller name (should use 'carrier' product instead)
- Invalid or unassigned number returns valid:false with no carrier data
- Payment failure via x402 prevents the lookup from completing
- Rate limits or upstream carrier data unavailability may cause timeouts

## How this service works

Tenjin is the tool router for coding agents. Install it once, and it hands your agent the right tool when it helps, paid from one wallet.

## Output

Returns a JSON object with: a validity flag, the carrier name, ported carrier (if applicable), line type (mobile/landline/etc.), city and state location based on rate center, country code, national formatted number, mobile network MCC and MNC codes, and (for the 'name' product on US numbers) the CNAM caller name on record.

## 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-867638c9/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from tenjin.sh](https://www.zero.xyz/host/tenjin.sh/llms.txt)