DISCOVERY SIGNALS · LIVE FROM THE INDEX

Which APIs have a public OpenAPI spec?

17%

of the APIs in the Discry Index publish a machine-readable OpenAPI spec.

68 pass103 partial224 failof 395 scanned

What this signal is

An OpenAPI spec is the machine-readable contract for a REST API: endpoints, parameters, schemas, auth. Agents use it to construct and validate real calls instead of guessing shapes from prose.

Discry checks that a spec is publicly fetchable and linked from the docs surface. A spec that exists only inside a rendered docs UI, unreachable by plain HTTP, fails the agent that needs it most.

Definition →How to ship it →

Notable passes and misses

Stripe, OpenAI, GitHub, Slack, Twilio, Cloudflare, Vercel, and Plaid all publish fetchable specs. The fails cluster into two patterns: APIs with no public spec at all, and APIs whose spec is embedded in a JavaScript-rendered reference that a plain fetch never sees — Airtable, Contentful, and Postmark sit in the miss column today.

Every API, checked

395 APIs
Pass68
Show the other 38
Partial103
Show the other 73
Fail224
Show the other 194

Does your API pass this check?

Find out in about a minute — no signup.

Discry your API — free

Check data assessed under Discry methodology 3.0.0 · Methodology