# Twilio — API Agent Score

> Score: 88/100 (Grade: A) | Domain: twilio.com | Rubric: 1.0.0 | Checked: July 24, 2026

Twilio scored 88/100 (A), classified "ai-ready".

[View full report](https://www.postman.com/ai/ai-ready-apis/company/twilio)
[All organizations](https://www.postman.com/ai/ai-ready-apis/llms.txt)

## Summary

- Overall: 88/100 (A)
- Classification: ai-ready

## Category Scores

- API Design: 94/100 (A+)
- Developer Experience: 100/100 (A+)
- Agent Discovery: 78/100 (B)
- Agent Understanding: 78/100 (B)
- Agent Usability: 96/100 (A+)

## Check Results

### API Design

- [pass] Auth declared & discoverable — Authentication required (global or on every operation). Investigated: spec 100%, docs 100%.
- [warn] Schema coverage & depth — 38420/39106 (98%) public params are fully typed (no any/**kwargs). Analyzer reports not all methods have a derivable input schema. Investigated: sdk 100%, spec 67%.
- [warn] Machine-readable, versioned contract — info.version="1.0.0" set but no versioning scheme (URL / header / media type) detected. Investigated: spec 75%, docs 50%.
- [pass] Security & governance hygiene — No credential-shaped strings detected in spec. Investigated: spec 100%, wellknown 50%.
- [pass] Example coverage — 25% example coverage. Investigated: spec 100%, docs 100%, sdk 100%.

### Developer Experience

- [pass] Self-service developer portal — Signup page at https://auth.twilio.com/login?iss=https%3A%2F%2Flogin.twilio.com%2F (CSR-rendered — body classifier inconclusive); free tier / sandbox documented in pricing/docs. Investigated: docs 100%.
- [pass] Quickstart present — Quickstart at https://www.twilio.com/en-us/products with a runnable first-call sample. Investigated: docs 100%.
- [pass] Code samples in docs — Code samples in 8 language(s) across docs (top: javascript, python, csharp); 2/20 pages have ≥ 2 languages on the same page. Investigated: docs 100%.
- [pass] Description completeness — 69% description completeness (target 90%+). Investigated: spec 100%, sdk 97%.
- [pass] Changelog published — changelog documented in the docs site at https://www.twilio.com/en-us/changelog. Investigated: spec 100%, docs 100%, sdk 100%.

### Agent Discovery

- [pass] Registry & SDK presence — Indexed on Context7 (llmstxt/twilio_llms_txt, 28145 snippets). Investigated: docs 100%, cli 100%, sdk 50%, mcp 0%, wellknown 0%.
- [warn] Docs reachable, not hard auth-gated — 1 of 50 sampled pages require authentication (49 accessible). Investigated: docs 90%.
- [warn] llms.txt present, valid & comprehensive — No llms.txt directive found in HTML of any of 50 sampled pages. Investigated: docs 33%, sdk 0%.
- [warn] Crawlable / AEO — Sitemap lastmod coverage 100% or newest entry older than 90 days. Investigated: wellknown 75%.

### Agent Understanding

- [pass] Machine-readable errors (RFC 9457) — error codes documented in the docs site at https://www.twilio.com/docs/api/errors. Investigated: docs 100%, spec 50%, sdk 0%.
- [warn] Operation purpose clarity — 76% of operations are agent-inferable (target 90%+). Investigated: spec 75%.
- [warn] Agent-navigable, token-efficient docs — 8 of 50 pages have substantive content differences between markdown and HTML (avg 8% missing). Investigated: docs 61%.
- [pass] Docs structured data — JSON-LD Article markup on 12/12 assessed pages (100%) with dateModified present. Investigated: docs 100%.
- [fail] Agent instructions file (AGENTS.md) — No AGENTS.md at the site root or /.well-known/. Investigated: wellknown 0%.
- [skip] Description consistency across surfaces — Only 1 surface description(s) with ≥6 tokens available; need at least 2 to compare.

### Agent Usability

- [pass] Idempotency documented — Built-in retry machinery is present (grep-derived). Investigated: sdk 100%, spec 0%, docs 0%.
- [pass] Rate-limit signaling — rate-limit behavior documented in the docs site at https://www.twilio.com/docs/usage/rest-api-best-practices. Investigated: spec 100%, docs 100%.
- [pass] Pagination documented & consistent — pagination documented in the docs site at https://www.twilio.com/docs/ai/skills. Investigated: docs 100%, spec 50%, sdk 0%.
- [pass] Sandbox separation — sandbox documented in the docs site at https://www.twilio.com/docs/flex/admin-guide/setup/conversations/manage-conversations-whatsapp-addresses. Investigated: spec 100%, docs 100%, sdk 100%.
- [warn] Runnable collection with test scripts — No test scripts found in the workspace's collections. Investigated: platform 50%.

## Executive Summary

Twilio's API program shows strong fundamentals in API design and schema quality, giving partners a solid contract to build against. The most urgent gap is the absence of an agent instructions file, which leaves AI agents without the structured context they need to navigate Twilio's API surface confidently — slowing autonomous integration and increasing error rates. Secondary weaknesses in agent discovery mean partners and their agents may not find the right documentation entry point without a sales conversation. Prioritizing agent context and discovery infrastructure will unlock faster, self-serve partner and AI-agent onboarding at scale.