How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Telnyx

Telnyx Addresses API

Operations to work with Address records. Address records are emergency-validated addresses meant to be associated with phone numbers. They are validated for emergency usage purposes at creation time, although you may validate them separately with a custom workflow using the ValidateAddress operation separately. Address records are not usable for physical orders, such as for Telnyx SIM cards, please use UserAddress for that. It is not possible to entirely skip emergency service validation for Address records; if an emergency provider for a phone number rejects the address then it cannot be used on a phone number. To prevent records from getting out of sync, Address records are immutable and cannot be altered once created. If you realize you need to alter an address, a new record must be created with the differing address.

Documentation Provider Profile APIs.io OpenAPI GitHub

Telnyx Addresses API is one of 169 APIs that Telnyx publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Addresses. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 6 operations across 4 paths, and defines 25 schemas. It is described by OpenAPI 3.2.0, at version 2.0.0.

Requests are made against a single base URL, https://api.telnyx.com/v2.

6 operations 4 paths 25 schemas 1 DELETE2 GET3 POST

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
2.0.0
Base URL
https://api.telnyx.com/v2
Authentication
HTTP Bearer, HTTP Bearer, OAuth 2.0, HTTP Bearer, HTTP Bearer, HTTP Bearer
Contact
support@telnyx.com
Resource Areas
1

Authentication & Security 6

Telnyx Addresses API declares 6 security schemes for authenticating requests. It accepts HTTP bearer tokens (bearerAuth). It accepts HTTP bearer tokens (branded-calling_bearerAuth). It supports OAuth 2.0 (oauthClientAuth) using the authorizationCode and clientCredentials flows, exposing 1 scope. It accepts HTTP bearer tokens (JWT) (outbound-voice-profiles_bearerAuth). It accepts HTTP bearer tokens (pronunciation-dicts_bearerAuth). It accepts HTTP bearer tokens (JWT) (stored-payment-transactions_bearerAuth). By default, every request must be authenticated.

  • branded-calling_bearerAuth — API key passed as a Bearer token in the Authorization header
  • oauthClientAuth — OAuth 2.0 authentication for Telnyx API and MCP integrations
  • pronunciation-dicts_bearerAuth — Telnyx API v2 key. Obtain from https://portal.telnyx.com

Paths & Operations 6

Across 4 paths, the API surfaces 6 operations — 1 DELETE, 2 GET, 3 POST. Each is listed below with its method, path, parameters, and response codes.

Addresses 6

Operations to work with Address records.

GET
/addresses
List all addresses
FindAddresses 3 params → 200400401404
POST
/addresses
Creates an address
CreateAddress body → 200422
POST
/addresses/actions/validate
Validate an address
ValidateAddress body → 200422
DELETE
/addresses/{id}
Deletes an address
DeleteAddress 1 param → 200401404422
GET
/addresses/{id}
Retrieve an address
GetAddress 1 param → 200401404422
POST
/addresses/{id}/actions/accept_suggestions
Accepts this address suggestion as a new emergency address for Operator Connect…
acceptAddressSuggestions 1 param body → 200202404

Schemas 25

The contract defines 25 schemas that model the data the API accepts and returns. The most detailed are Address (19 properties), AddressCreate (15 properties), ValidateAddressRequest (6 properties), ValidateAddressField (6 properties). Each schema is shown below with its type and property counts.

neighborhood
string
The neighborhood of the address. This field is not used for addresses in the US but is used for some international addresses.
PaginationMeta
object
4 properties
locality
string
The locality of the address. For US addresses, this corresponds to the city of the address.
administrative_area
string
The locality of the address. For US addresses, this corresponds to the state of the address.
postal_code
string
The postal code of the address.
Error
object
5 properties 2 required
ValidateAddressResult
object
4 properties 2 required
country_code
string
The two-character (ISO 3166-1 alpha-2) country code of the address.
Address
object
19 properties
borough
string
The borough of the address. This field is not used for addresses in the US but is used for some international addresses.
customer_reference
string
A customer reference string for customer look ups.
address_book
boolean
Indicates whether or not the address should be considered part of your list of addresses that appear for regular use.
ValidateAddressRequest
object
6 properties 3 required
business_name
string
The business name associated with the address. An address must have either a first last name or a business name.
extended_address
string
Additional street address information about the address such as, but not limited to, unit number or apartment number.
street_address
string
The primary street address information about the address.
validate_address
boolean
Indicates whether or not the address should be validated for emergency use upon creation or not. This should be left with the default value of true unless you…
first_name
string
The first name associated with the address. An address must have either a first last name or a business name.
ValidateAddressField
object
6 properties
AcceptSuggestionsRequest
object
1 property
AddressSuggestionResponse
object
1 property
ResourceNotFoundError
object
1 property
AddressCreate
object
15 properties 6 required
phone_number
string
The phone number associated with the address.
last_name
string
The last name associated with the address. An address must have either a first last name or a business name.

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

telnyx-addresses-api-openapi.yml Raw ↑

Other APIs Telnyx publishes across the network.

Telnyx Access Tokens API
AE Profile APIs.io
Telnyx Advanced Number Orders API
AE Profile APIs.io
Telnyx Assistants API
AE Profile APIs.io
Telnyx Audio API
AE Profile APIs.io
Telnyx Audit Logs API
AE Profile APIs.io
Telnyx Authentication Providers API
AE Profile APIs.io
Telnyx AutoRechargePreferences API
AE Profile APIs.io
Telnyx Billing API
AE Profile APIs.io
Telnyx Billing Groups API
AE Profile APIs.io
Telnyx Brands API
AE Profile APIs.io
Telnyx Bucket SSL Certificate API
AE Profile APIs.io
Telnyx Bucket Usage API
AE Profile APIs.io
#Addresses
← Back to T APIs
API Details
ID
telnyx:telnyx-addresses-api
Base URL
https://api.telnyx.com/v2
Docs
https://developers.telnyx.com/api
Provider
Telnyx
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network
Work with this as data

Every API here is available over the API and to AI agents over MCP. APIs is not yet its own endpoint on the v1 API. Reach this content through network search and the tag graph, or the MCP server below.

Installs https://mcp.apievangelist.com/mcp in Claude, Cursor, VS Code and the rest — one button, every client.

MCP tools for apis
4 tools reach this content
  • search_api_evangelistSearch every content type across the network at once.
  • find_relatedThe shared-tag relevance graph — what else covers this.
  • get_tagEverything one tag labels, across all content types.
  • guide_topicPRO — a curated bundle for a topic: area, guidance, rules, papers, stories, services.
All tools & prompts
Call it yourself
curl for this page
Search the network for this 
curl "https://api.apievangelist.com/v1/search?q=telnyx-addresses-api&limit=10"
Everything under a tag 
curl "https://api.apievangelist.com/v1/tags/telnyx-addresses-api"

Discovery needs no key. Full bodies and the synthesis endpoints are Pro.

Get an API key

Free tier, no email required. Sign in with whichever identity you already have.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have. Your account

Where this information came from

This is an independent, third-party profile of Telnyx Addresses API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.