Skip to content

Telnyx API API

by telnyx.com

Bearer tokenHTTPSPhone
Open documentation ↗

Overview

SIP trunking, SMS, MMS, Call Control and Telephony Data Services.

Telnyx API is a phone API from telnyx.com. Requests are authenticated with a bearer token. It is served over HTTPS. Its OpenAPI description documents 361 endpoints.

At a glance

Authentication
Bearer token
HTTPS
Yes
CORS
Unknown
Category
Phone
Base URL
https://api.telnyx.com/v2
Version
2.0.0
Endpoints
361
Spec updated
2021-08-23

Make a first request

Replace the placeholders; the documentation says exactly where credentials go.

cURL
curl -X GET "https://api.telnyx.com/v2/addresses" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN"
JavaScript
const response = await fetch("https://api.telnyx.com/v2/addresses", {
  method: "GET",
  headers: {
    "Accept": "application/json",
    "Authorization": "Bearer YOUR_TOKEN",
  },
});
const data = await response.json();
console.log(data);
Python
import requests

response = requests.request(
    "GET",
    "https://api.telnyx.com/v2/addresses",
    headers={
    "Accept": "application/json",
    "Authorization": "Bearer YOUR_TOKEN",
    },
    timeout=30,
)
print(response.json())

Endpoints

MethodPathWhat it does
POST/actions/bulk/telephony_credentialsCreates several credentials
PATCH/actions/bulk/telephony_credentialsUpdate several credentials
DELETE/actions/bulk/telephony_credentialsDelete several credentials
PUT/actions/network_preferences/sim_cardsBulk Network Preferences for SIM cards
POST/actions/register/sim_cardsRegister SIM cards
POST/actions/{action}/telephony_credentialsPerform activate or deactivate action on all credentials filtered by the provided tag.
GET/addressesList all addresses
POST/addressesCreates an address
POST/addresses/actions/validateValidate an address
GET/addresses/{id}Retrieve an address
DELETE/addresses/{id}Deletes an address
GET/authentication_providersList all SSO authentication providers
POST/authentication_providersCreates an authentication provider
GET/authentication_providers/{id}Retrieve an authentication provider
PATCH/authentication_providers/{id}Update a authentication provider
DELETE/authentication_providers/{id}Deletes an authentication provider
GET/available_phone_number_blocksList available phone number blocks
GET/available_phone_numbersList available phone numbers
GET/balanceRetrieve user balance details
GET/billing_groupsList all billing groups
POST/billing_groupsCreate a billing group
GET/billing_groups/{id}Retrieve a billing group
PATCH/billing_groups/{id}Update a billing group
DELETE/billing_groups/{id}Delete a billing group
GET/call_control_applicationsList call control applications
POST/call_control_applicationsCreate a call control application
GET/call_control_applications/{id}Retrieve a call control application
PATCH/call_control_applications/{id}Update a call control application
DELETE/call_control_applications/{id}Delete a call control application
GET/call_eventsList call events
POST/callsDial
GET/calls/{call_control_id}Retrieve a call status
POST/calls/{call_control_id}/actions/answerAnswer call
POST/calls/{call_control_id}/actions/bridgeBridge calls
POST/calls/{call_control_id}/actions/enqueueEnqueue call
POST/calls/{call_control_id}/actions/fork_startForking start
POST/calls/{call_control_id}/actions/fork_stopForking stop
POST/calls/{call_control_id}/actions/gather_stopGather stop
POST/calls/{call_control_id}/actions/gather_using_audioGather using audio
POST/calls/{call_control_id}/actions/gather_using_speakGather using speak
POST/calls/{call_control_id}/actions/hangupHangup call
POST/calls/{call_control_id}/actions/leave_queueRemove call from a queue
POST/calls/{call_control_id}/actions/playback_startPlay audio URL
POST/calls/{call_control_id}/actions/playback_stopStop audio playback
POST/calls/{call_control_id}/actions/record_pauseRecord pause
POST/calls/{call_control_id}/actions/record_resumeRecord resume
POST/calls/{call_control_id}/actions/record_startRecording start
POST/calls/{call_control_id}/actions/record_stopRecording stop
POST/calls/{call_control_id}/actions/referSIP Refer a call
POST/calls/{call_control_id}/actions/rejectReject a call
POST/calls/{call_control_id}/actions/send_dtmfSend DTMF
POST/calls/{call_control_id}/actions/speakSpeak text
POST/calls/{call_control_id}/actions/transcription_startTranscription start
POST/calls/{call_control_id}/actions/transcription_stopTranscription stop
POST/calls/{call_control_id}/actions/transferTransfer call
GET/commentsRetrieve all comments
POST/commentsCreate a comment
GET/comments/{id}Retrieve a comment
PATCH/comments/{id}/readMark a comment as read
GET/conferencesList conferences
POST/conferencesCreate conference
GET/conferences/{conference_id}/participantsList conference participants
GET/conferences/{id}Retrieve a conference
POST/conferences/{id}/actions/dial_participantDial a new participant into a conference
POST/conferences/{id}/actions/holdHold conference participants
POST/conferences/{id}/actions/joinJoin a conference
POST/conferences/{id}/actions/leaveLeave a conference
POST/conferences/{id}/actions/muteMute conference participants
POST/conferences/{id}/actions/playPlay audio to conference participants
POST/conferences/{id}/actions/record_startConference recording start
POST/conferences/{id}/actions/record_stopConference recording stop
POST/conferences/{id}/actions/speakSpeak text to conference participants
POST/conferences/{id}/actions/stopStop audio being played on the conference
POST/conferences/{id}/actions/unholdUnhold conference participants
POST/conferences/{id}/actions/unmuteUnmute conference participants
POST/conferences/{id}/actions/updateUpdate conference participant
GET/connectionsList connections
GET/connections/{id}Retrieve a connection
GET/credential_connectionsList credential connections
POST/credential_connectionsCreate a credential connection
GET/credential_connections/{id}Retrieve a credential connection
PATCH/credential_connections/{id}Update a credential connection
DELETE/credential_connections/{id}Delete a credential connection
GET/detail_recordsSearch detail records
GET/document_linksList all document links
GET/documentsList all documents
POST/documentsUpload a document
GET/documents/{id}Retrieve a document
PATCH/documents/{id}Update a document
DELETE/documents/{id}Delete a document
GET/documents/{id}/downloadDownload a document
GET/fax_applicationsList all Fax Applications
POST/fax_applicationsCreates a Fax Application
GET/fax_applications/{id}Retrieve a Fax Application
PATCH/fax_applications/{id}Update a Fax Application
DELETE/fax_applications/{id}Deletes a Fax Application
GET/faxesView a list of faxes
POST/faxesSend a fax
GET/faxes/{id}View a fax
DELETE/faxes/{id}Delete a fax

Showing the first 100 of 361 endpoints; the full list is in the documentation.

Questions

Does the Telnyx API API need an API key?

Yes. The Telnyx API API uses Bearer token authentication; the documentation explains how to get credentials.

Does the Telnyx API API support HTTPS?

Yes, the Telnyx API API is served over HTTPS.

How many endpoints does the Telnyx API API have?

Its OpenAPI description lists 361 endpoints in version 2.0.0. The first 100 are shown on this page.

What are alternatives to the Telnyx API API?

Other Phone APIs include Twilio - Accounts, ETSI GS MEC 010-2 - Part 2: Application lifecycle, rules and requirements management, Twilio - Api, Mobility API, Twilio - Autopilot.

Compare alternatives →

Listed from APIs.guru (CC0).