# Stripe — API Agent Score

> Score: 86/100 (Grade: A) | Domain: stripe.com | Rubric: 1.0.0 | Checked: July 27, 2026

Stripe scored 86/100 (A), classified "ai-ready".

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

## Summary

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

## Category Scores

- API Design: 89/100 (A)
- Developer Experience: 100/100 (A+)
- Agent Discovery: 82/100 (A)
- Agent Understanding: 71/100 (B)
- Agent Usability: 96/100 (A+)

## Check Results

### API Design

- [pass] Machine-readable, versioned contract — Versioning declared (info.version="2026-06-24.dahlia") and date-based-versioning detected. Investigated: spec 100%, docs 100%.
- [pass] Auth declared & discoverable — Authentication required (global or on every operation). Investigated: spec 100%, docs 100%.
- [pass] Security & governance hygiene — No credential-shaped strings detected in spec. Investigated: spec 100%, wellknown 100%.
- [warn] Schema coverage & depth — Only 0% of operations have documented schemas. Investigated: spec 50%.
- [pass] Example coverage — 0% example coverage. Investigated: spec 100%, docs 100%.

### Developer Experience

- [pass] Self-service developer portal — Self-service signup at https://dashboard.stripe.com/register; no free tier or sandbox language detected. Investigated: docs 100%.
- [pass] Quickstart present — Quickstart at https://docs.stripe.com/checkout/quickstart has a runnable sample in the .md variant (https://docs.stripe.com/checkout/quickstart.md). Investigated: docs 100%.
- [pass] Code samples in docs — Code samples present on 2/20 pages across 1 language(s); broader multi-language coverage missing. Investigated: docs 100%.
- [pass] Description completeness — 17% description completeness. Investigated: spec 100%.
- [pass] Changelog published — changelog documented in the docs site at https://docs.stripe.com/changelog. Investigated: spec 100%, docs 100%, sdk 100%.

### Agent Discovery

- [pass] Registry & SDK presence — Discovered SDKs in 13 distinct languages. Investigated: sdk 100%, cli 100%, mcp 100%, docs 0%, wellknown 0%.
- [warn] Docs reachable, not hard auth-gated — Content negotiation partially supported: 0 correct type, 49 wrong type, 1 HTML only. Investigated: docs 88%.
- [warn] llms.txt present, valid & comprehensive — llms.txt covers 469/4205 sitemap doc pages (11%); 3736 missing; 12 llms.txt links not in sitemap (may indicate stale links or incomplete sitemap). Investigated: docs 50%.
- [warn] Crawlable / AEO — Sitemap present (4614 entries) but carries no lastmod values. Investigated: wellknown 75%.

### Agent Understanding

- [pass] Machine-readable errors (RFC 9457) — error codes documented in the docs site at https://docs.stripe.com/error-codes. Investigated: spec 100%, docs 100%.
- [pass] Operation purpose clarity — 98% of operations have a clear summary + operationId an agent can select on. Investigated: spec 100%.
- [warn] Agent-navigable, token-efficient docs — 3 of 50 sampled pages appear to be client-side rendered SPA shells (root detected); agents using HTTP fetches will see no content. Investigated: docs 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 1 assessed pages (1 JS-rendered). Investigated: docs 0%.
- [fail] Description consistency across surfaces — Mean pairwise description similarity across 2 surfaces (spec, docs) is 0% (threshold 35% for full credit).

### Agent Usability

- [pass] Idempotency documented — idempotency documented in the docs site at https://docs.stripe.com/api/idempotent_requests. Investigated: spec 100%, docs 100%.
- [pass] Rate-limit signaling — rate-limit behavior documented in the docs site at https://docs.stripe.com/rate-limits. Investigated: spec 100%, docs 100%.
- [pass] Pagination documented & consistent — Pagination params detected on 127 list endpoint(s). Investigated: spec 100%, docs 100%.
- [pass] Sandbox separation — sandbox documented in the docs site at https://docs.stripe.com/testing-use-cases. Investigated: spec 100%, docs 100%.
- [warn] Runnable collection with test scripts — No test scripts found in the workspace's collections. Investigated: platform 50%.

## Executive Summary

Stripe's API program is exceptionally strong in usability and discoverability — partners can find, explore, and run real workflows with confidence. The clearest gaps are in agent-readiness: there is no AGENTS.md instruction file to guide AI coding agents, documentation lacks structured data and consistent descriptions across surfaces, making it harder for agents to parse and act on context reliably. Prioritizing these agent-understanding gaps will ensure that partners using AI-assisted development tools integrate correctly the first time, without guesswork or hallucination.