getting started

Quickstart

Get your first response in under two minutes. No approval, no contracts, no carrier onboarding.

1. Install the SDK

bash

npm install @telnext/sdk

2. Set your API key

bash

export TELNEXT_API_KEY=sk_sandbox_xxxxxxxxxxxx

Sandbox keys start with sk_sandbox_. Live keys start with sk_live_. Zero code changes between environments.

3. Make a request

typescript

import { Telnext } from '@telnext/sdk'

const client = new Telnext({
  apiKey: process.env.TELNEXT_API_KEY
})

const result = await client.location.verify({
  phoneNumber: '+5511999990000',
  latitude: -23.5505,
  longitude: -46.6333,
  radius: 300,
})

console.log(result.verificationResult)
// → { withinRadius: true, carrier: 'Vivo', confidence: 0.97 }

Error format

All errors follow the same envelope. The trace_id field is always present — include it when filing a support request.

json

{
  "error": "no_route_available",
  "message": "No provider could serve the request for BR-VIVO.",
  "attempted": [
    { "provider": "sinch",   "result": "timeout" },
    { "provider": "twilio",  "result": "503"     },
    { "provider": "infobip", "result": "unsupported" }
  ],
  "retry_after": 30,
  "status_page": "status.telnext.dev",
  "trace_id": "req_8f2a1c",
  "timestamp": "2026-05-25T14:02:11Z"
}

Full API reference, webhook docs, and SDK guides are in progress. Join the early access list to get notified when they go live.