Skip to main content
GET
Get carrier account
One connected Telnyx account with its numbers, status and last refusal. Requires carrier_accounts:read.
With a carrier_accounts:manage key the response also carries webhook_url: the exact URL a Call Control App you made must use. It contains a secret for your account, so treat it like a password. signature_verified turns true after the first call event that verified against your public key. If last_error.code is public_key_mismatch, the public key you saved does not match your Telnyx account: update it. Another workspace’s id answers 404 CARRIER_ACCOUNT_NOT_FOUND.

Authorizations

Authorization
string
header
required

Your Yappr API key (e.g. ypr_live_...). Generate one in the dashboard under Settings → API Keys.

Path Parameters

id
string<uuid>
required

Response

The account

data
object

Your own Telnyx account, connected so agents can call from the numbers you own there. Yappr places each call on your Call Control App, with your API key, so the call runs on your Telnyx account and Telnyx bills you for it. The API key is write-only: no response ever contains it.