How Telebase works

How Telebase works

A single API call. Real-time telecom intelligence.

A single API call. Real-time telecom intelligence.

Request early access

Telebase sits between your AI agents and the carrier networks that hold phone number data.
Instead of negotiating enterprise contracts with telecoms, integrating multiple providers, and building billing infrastructure — you make one API call and we handle everything behind the scenes.

Step 1 — Create your account

Step 1 — Create your account

Go to telebase.io, enter your email, and you'll receive an API key instantly. No approval process, no sales call, no waiting.

Go to telebase.io, enter your email, and you'll receive an API key instantly. No approval process, no sales call, no waiting.

Step 2 — Top up your balance

Step 2 — Top up your balance

Add credit to your account via Paddle — card or bank transfer. Your balance is available immediately. Start with as little as $10.

Step 3 — Make your first query

Step 3 — Make your first query

Send a POST request with a phone number in E.164 format. Include your API key in the Authorization header. That's it.

Send a POST request with a phone number in E.164 format. Include your API key in the Authorization header. That's it.

Step 4 — Get the result

Within 500ms you'll receive a normalised JSON response with carrier, active status, number type, SIM swap history, and roaming status. Your balance is automatically debited $0.03.

Within 500ms you'll receive a normalised JSON response with carrier, active status, number type, SIM swap history, and roaming status. Your balance is automatically debited $0.03.

Within 500ms you'll receive a normalised JSON response with carrier, active status, number type, SIM swap history, and roaming status. Your balance is automatically debited $0.03.

Step 5 — Scale

Your agents can fire thousands of queries per hour. Every query is logged with timestamp, result, and cost. Your balance depletes as you go — top up whenever you need to.

The API Call

POST https://api.telebase.io/lookup
Authorization: Bearer sk_live_xxxxxxxxxxxx
Content-Type: application/json

{
  "number": "+447911123456"
}

Response

{
  "active": true,
  "carrier": "EE UK",
  "country": "GB",
  "type": "mobile",
  "sim_swap_last_24h": false,
  "roaming": false,
  "query_id": "qry_abc123",
  "cost": 0.03
}

Billing

No monthly minimums. You only pay for queries you actually make. Your balance never expires. Set a low balance alert in your dashboard and we'll email you before you run out.

Pricing: $0.03 per query, flat rate. No tiers, no commitments.

Who it’s for.

Fraud & risk teams — Stop account takeover before it happens. Query SIM swap and carrier signals at the moment of transaction, not after. Neobanks · BNPL · Payment processors.

Fraud & risk teams — Stop account takeover before it happens. Query SIM swap and carrier signals at the moment of transaction, not after. Neobanks · BNPL · Payment processors.

KYC.

KYC & identity platforms — Add a live telecom signal layer to your verification stack. Integrate once, offer to all clients. Identity verification · Onboarding · Compliance.

KYC & identity platforms — Add a live telecom signal layer to your verification stack. Integrate once, offer to all clients. Identity verification · Onboarding · Compliance.

AI Agents.

AI agent builders — One SDK, full telecom intelligence. Agent-native discovery. No enterprise sales. Fintech · Fraud automation · Risk scoring.

AI agent builders — One SDK, full telecom intelligence. Agent-native discovery. No enterprise sales. Fintech · Fraud automation · Risk scoring.

What happens if my balance hits zero?

The API returns a 402 Payment Required response. No query is made to the carrier so you're never charged for a failed query.

Do you store phone numbers?

Never. Every phone number is immediately hashed with SHA-256 before logging.

What AI agent frameworks does this work with?

Any framework that can make an HTTP request — LangChain, AutoGPT, CrewAI, custom-built agents.

Early access.

Early access.

We are currently in Private Beta.
Enter your email to join the waitlist.

We are currently in Private Beta.
Enter your email to join the waitlist.