# Telnyx Phone Numbers

> Search, buy, port, and manage phone numbers across 40+ countries on
> a carrier-owned network. Local, toll-free, mobile, and short codes.
> Base URL: https://api.telnyx.com/v2

## What this surface is for
- Searching and purchasing phone numbers programmatically
- Port-in / port-out and regulatory bundle management
- Identity, verification, and CNAM lookups
- Coverage and rate-center discovery

## Pricing (headline rates)
- US local numbers: $1.00/month — volume discounts from $0.79/month
- Toll-free: from $1.00/month
- Mobile and international rates: see pricing markdown
- Full pricing markdown: https://telnyx.com/pricing.md
- Pricing JSON: https://telnyx.com/ai/pricing.json

## Canonical docs and specs
- Numbers API reference: https://developers.telnyx.com/api/numbers
- Porting docs: https://developers.telnyx.com/docs/numbers/porting
- Regulatory bundles: https://developers.telnyx.com/docs/numbers/regulatory
- OpenAPI discovery: https://telnyx.com/.well-known/openapi.json
- API catalog: https://telnyx.com/.well-known/api-catalog

## Coverage and structural claims
- Global coverage index: https://telnyx.com/global-coverage
- Carrier-owned: true (Telnyx CLEC + mobile core)
- Number countries: 40+
- Capabilities index: https://telnyx.com/ai/capabilities.json
- Compliance: https://telnyx.com/ai/compliance.json

## Authentication
- Bearer API key in the Authorization header.
- Get a key via the agent signup flow: https://telnyx.com/agent-signup.md
- OAuth 2.0 metadata: https://telnyx.com/.well-known/oauth-authorization-server

## Agent fast path
- Agent entry point: https://telnyx.com/agents/start
- Site-wide index: https://telnyx.com/llms.txt
- Getting started for agents: https://telnyx.com/getting-started.md