# Truecaller Lookup API

> Truecaller Lookup API is a paid API for AI agents from kite-hub-v2.vercel.app, paid per call via x402, $0.19/call, status unknown (last checked 2026-09-16).

Looks up a phone number against the Truecaller database to retrieve caller identity, name, and associated metadata

## Facts

- Endpoint: POST https://kite-hub-v2.vercel.app/api/truecaller-lookup
- Price: $0.19/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-16
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/truecaller-lookup-api-f1cd9557
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_1mArJBo8VSW3Gmx2TPANl

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 truecaller-lookup-api-f1cd9557 -d '<json body>'
```

Example prompt: Can you look up who owns the phone number +1-555-867-5309 using Truecaller and tell me the name and any spam rating associated with it?

## When to prefer this

Use this endpoint when you need to identify the owner of an unknown phone number, especially when Truecaller's crowdsourced caller ID database is the preferred source. Best for reverse phone lookups on mobile numbers, spam detection, or enriching contact records with caller name data. Prefer over generic CNAM lookups when crowdsourced identity and spam scoring are important.

## Known failure modes

- Phone number not found in Truecaller database — returns empty or null result
- Invalid phone number format — API returns validation error
- Number exists but has no public name listing — partial result returned
- Rate limiting or quota exceeded — HTTP 429 or payment error
- Unparseable or non-E.164 phone number input

## How this service works

400+ paid API endpoints. Social media, AI, crypto, finance, weather, ecommerce, tools. Pay per request with USDC on Base chain.

## Output

Returns caller identity data from the Truecaller database including the registered name, possible spam classification, carrier, and location associated with the queried phone number.

## Response schema (JSON Schema)

```json
{
 "type": "object",
 "example": {
  "result": {
   "data": "example response"
  }
 },
 "properties": {
  "result": {
   "type": "object",
   "description": "API response data"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/truecaller-lookup-api-f1cd9557/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from kite-hub-v2.vercel.app](https://www.zero.xyz/host/kite-hub-v2.vercel.app/llms.txt)