Developer API

Resell telly.cat numbers from your own platform. Get an API key from your dashboard, then call any endpoint below.

Authentication

Pass your key on every request as an X-Api-Key header.

curl https://telly.cat/api/v1/balance \
  -H "X-Api-Key: YOUR_KEY"

Base URL: https://telly.cat/api/v1 · Rate limit: 60 requests/minute per key.

GET /balance

Returns your current wallet balance.

{ "balance": 42.5 }

GET /prices?country=england&product=whatsapp

Live offers for a country/service, cheapest first.

{ "offers": [
  { "operator": "vodafone", "cost": 0.11, "sale": 0.16, "count": 940, "rate": 98.2 }
] }

POST /buy

Buy a number. Body: { "country", "product", "operator" } (operator optional, defaults to cheapest).

curl -X POST https://telly.cat/api/v1/buy \
  -H "X-Api-Key: YOUR_KEY" -H "Content-Type: application/json" \
  -d '{"country":"england","product":"whatsapp"}'

Returns the created order object, including phone once assigned.

GET /orders

Lists your most recent 100 orders.

GET /orders/:id

Refreshes and returns one order's status, phone number, and SMS code once received.

{ "id": 123, "phone": "+44...", "status": "RECEIVED", "sms_code": "482913", ... }

POST /orders/:id/cancel

Cancels a pending order and refunds the balance, if eligible.

POST /orders/:id/finish

Marks an order complete once you've used the code.

Order statuses

PENDING · RECEIVED · FINISHED · CANCELED · TIMEOUT · BANNED · FAILED