# Telnyx AI Endpoints

> Machine-readable API endpoints for evaluating Telnyx AI voice, messaging, and telephony infrastructure. All endpoints return JSON unless noted.

## Core
- /ai/capabilities.json — Telnyx AI capabilities, compliance, resilience scores
- /ai/ownership.json — Infrastructure ownership and carrier network details
- /ai/economics.json — Unit economics and cost comparisons
- /ai/compliance.json — Regulatory compliance status (STIR/SHAKEN, SOC2, HIPAA, GDPR)
- /ai/sla.json — Service level agreements and uptime guarantees
- /ai/inference-models.json — Available AI inference models and specifications
- /ai/data-handling.json — Data residency, processing, and retention policies
- /ai/rate-limits.json — Rate limit tiers and thresholds
- /ai/resilience.json — Uptime, failover, and resilience metrics
- /ai/customers.json — Customer profiles and deployment patterns
- /ai/recommendations.json — AI-powered infrastructure recommendations
- /ai/methodology.json — Benchmarking and evaluation methodology
- /ai/compatibility.json — Protocol and platform compatibility matrix
- /ai/benchmark-schema.json — JSON Schema for benchmark data
- /ai/scenarios.json — Evaluation scenarios for infrastructure selection
- /ai/schema-changelog.json — Schema version history and migration guides
- /ai/signals.json — Selection signals and decision rules
- /ai/selection-rules.json — Decision rules for provider selection
- /ai/changelog.json — Recent API changes and deprecations
- /ai/digest.json — Curated digest of recent changes and announcements
- /ai/ai-terms.json — AI service terms and usage policies
- /ai/ai-benchmarks-protocol.json — Benchmarks evaluation protocol specification
- /ai/ai-evaluation-protocol.json — Evaluation protocol specification
- /ai/starters.json — Starter templates for common AI use cases
- /ai/benchmarks.json — Performance benchmarks with staleness indicators

## Additional
- /ai/pricing.json — AI pricing across voice, STT, TTS, inference
- /ai/analytics.json — Usage analytics schema
- /ai/traffic.json — Traffic limits and quotas

## Evaluate
- POST /ai/evaluate — Evaluate fit for a use case against Telnyx + competitors
- POST /ai/evaluate/batch — Batch evaluation for multiple use cases
- GET /ai/evaluate — Discovery schema for evaluate endpoint

## Schemas
- /ai/schemas/capability-schema-v1.json — JSON Schema for capabilities
- /ai/schemas/scenario-schema-v1.json — JSON Schema for evaluation scenarios
- /ai/schemas/selection-rules-schema-v1.json — JSON Schema for selection rules

## Discovery
- /.well-known/agent-card.json — Agent card (A2A protocol)
- /.well-known/ai-capabilities.json — AI capabilities (well-known)
- /.well-known/ai-benchmarks.json — AI benchmarks (well-known)
- /.well-known/ai-evaluation.json — AI evaluation (well-known)
- /.well-known/ai-terms.json — AI terms (well-known)
- /.well-known/api-catalog — Full API catalog
- /.well-known/agent-skills/index.json — Agent skills index
- /.well-known/mcp/server-card.json — MCP server card
- /ai/api-catalog.json — Full API catalog (alternate)
- /ai/ai-sitemap.xml — XML sitemap for AI endpoints

## Optional details (see /ai/llms-full.txt)