# PerCallAPI Caller ID Lookup

> PerCallAPI Caller ID Lookup is a paid API for AI agents from percallapi.com, paid per call via x402, $0.04/call, status unknown (last checked 2026-10-01).

Looks up registered caller name (CNAM), real-time line status, telecom carrier, and line type for a phone number via Twilio.

## Facts

- Endpoint: GET https://percallapi.com/caller-id?utm_source=zero.xyz
- Price: $0.04/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-01
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/percallapi-caller-id-lookup-28e41482
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_zdf8fotkaekKwkg2AyBPu

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 percallapi-caller-id-lookup-28e41482
```

Example prompt: Can you look up the caller ID name, carrier, line type, and whether the number +14157012311 is currently active?

## When to prefer this

Choose this endpoint when you need a combined CNAM + carrier + line type + active status check in a single real-time call, backed by Twilio's telecom data. Prefer it over carrier-only lookup endpoints when caller name identity matters, or over static WHOIS/number databases when you need live line status.

## Known failure modes

- Invalid or non-E.164 formatted phone number returns an error
- Number not found in CNAM registry returns empty caller name
- Twilio carrier lookup unavailable returns a timeout or service error
- Non-US numbers may return partial or no CNAM data
- Payment failure (x402) blocks the request from being processed

## How this service works

Lookup registered caller name (CNAM identity), real-time line status (active vs. inactive), telecom carrier, and line type via Twilio. Provide ?phone=+14157012311.

## Output

Returns the registered CNAM caller name, real-time line status (active vs. inactive), telecom carrier name, and line type (mobile, landline, or VoIP) for the provided phone number.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema"
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/percallapi-caller-id-lookup-28e41482/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from percallapi.com](https://www.zero.xyz/host/percallapi.com/llms.txt)