# Bandwidth — API Agent Score

> Score: 70/100 (Grade: B) | Domain: bandwidth.com | Rubric: 1.0.0 | Checked: July 24, 2026

Bandwidth scored 70/100 (B), classified "partially-ready".

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

## Summary

- Overall: 70/100 (B)
- Classification: partially-ready

## Category Scores

- API Design: 75/100 (B)
- Developer Experience: 59/100 (D)
- Agent Discovery: 83/100 (A)
- Agent Understanding: 59/100 (D)
- Agent Usability: 72/100 (B)

## Check Results

### API Design

- [pass] Schema coverage & depth — 194/194 (100%) public params are fully typed (no any/**kwargs). Analyzer confirms all methods have a derivable input schema. Investigated: sdk 100%.
- [pass] Example coverage — Code samples in 9 language(s) across docs (top: http, shell, javascript); 2/20 pages have ≥ 2 languages on the same page. Investigated: docs 100%, sdk 100%.
- [fail] Security & governance hygiene — No security.txt at /.well-known/security.txt or /security.txt. Investigated: wellknown 0%.
- [skip] Machine-readable, versioned contract — No surface produced evidence for this capability in this run.
- [skip] Auth declared & discoverable — No surface produced evidence for this capability in this run.

### Developer Experience

- [pass] Code samples in docs — Code samples in 9 language(s) across docs (top: http, shell, javascript); 2/20 pages have ≥ 2 languages on the same page. Investigated: docs 100%.
- [pass] Description completeness — 54/54 operations carry a description. Investigated: sdk 100%.
- [pass] Changelog published — Newest official SDK activity 1 day(s) ago. Investigated: sdk 100%.
- [fail] Self-service developer portal — Signup page is sales-gated (contact-sales/request-access language detected). Investigated: docs 0%.
- [fail] Quickstart present — No quickstart/getting-started page found at the conventional paths. Investigated: docs 0%.

### Agent Discovery

- [pass] Registry & SDK presence — Indexed on Context7 (bandwidth/cli, 665 snippets). Investigated: docs 100%, sdk 100%, cli 100%.
- [warn] Docs reachable, not hard auth-gated — Server ignores Accept: text/markdown header (0/50 sampled pages return markdown). Investigated: docs 75%.
- [warn] llms.txt present, valid & comprehensive — No llms.txt directive found in HTML of any of 50 sampled pages. Investigated: docs 58%, sdk 0%.
- [pass] Crawlable / AEO — No robots.txt on the docs host — AI crawlers unrestricted. Investigated: wellknown 100%.

### Agent Understanding

- [warn] Agent-navigable, token-efficient docs — 1 of 2 page(s) with tab headers don't distinguish between variants (e.g. "examples:​" repeats across 2 tab groups). Investigated: docs 80%.
- [warn] Machine-readable errors (RFC 9457) — Single base error "null" present, but only 1 subclass found; a richer hierarchy lets consumers catch narrowly. Investigated: sdk 50%.
- [fail] Agent instructions file (AGENTS.md) — No AGENTS.md at the site root or /.well-known/. Investigated: wellknown 0%.
- [fail] Docs structured data — Neither JSON-LD nor OpenGraph/meta tags detected across 17 sampled pages — likely a CSR-only docs site. Investigated: docs 0%.
- [skip] Operation purpose clarity — No surface produced evidence for this capability in this run.
- [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%.
- [warn] Sandbox separation — No test-mode flag or sandbox environment is exposed. Investigated: sdk 50%.
- [fail] Runnable collection with test scripts — No public Postman workspace discovered for the org. Investigated: platform 0%.
- [skip] Rate-limit signaling — No surface produced evidence for this capability in this run.
- [skip] Pagination documented & consistent — No surface produced evidence for this capability in this run.

## Executive Summary

Bandwidth's API program shows strength in agent discovery and documentation reachability, but leaves partners and their AI agents blocked at two critical junctures: onboarding and agent-readiness. There is no self-service portal or quickstart to get partners to a first working call, and the absence of an AGENTS.md file, structured docs metadata, and runnable collections with test scripts means AI coding agents cannot reliably interpret, discover, or execute against Bandwidth's APIs without manual hand-holding. Prioritize establishing a self-service developer portal with machine-readable docs first, then layer in runnable collections with test coverage to close the agent-usability gap.