OpenAPI Specification
Some data may be outdated — see provenance labels.
The OpenAPI Specification Repository observed · 2026-09-23
Health v2 · maintenance only
88/100
- Activity 96
- Release rhythm 70
- Longevity 100
How is this computed?
round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10) — computed 2026-10-21. Adoption (stars, forks) is never an input.
- gap_med: 164.5
- age_days: 4614
- days_rel: 40
- days_push: 28
- n_releases_24m: 5
Adoption not part of the score
31229 stars · 9154 forks observed · 2026-09-23
What it is AI-extracted, prompt v1, taxonomy v1, 2026-10-05, confidence 0.97
The OpenAPI Specification is a vendor-neutral, language-agnostic standard for describing HTTP APIs in JSON or YAML. It is maintained by the OpenAPI Initiative under the Linux Foundation and serves as the foundation for tooling, code generation, and documentation.
Use cases
- generate client SDKs from an API definition
- create interactive API documentation
- validate API definitions automatically
- drive API mock servers for testing
- enable contract-first API design workflows
- automate API security and compliance checks
When to choose
- You need a widely adopted, language‑agnostic way to describe RESTful HTTP APIs.
- You want to generate client libraries, server stubs, or documentation from a single source of truth.
- Your organization values tooling support across many languages and platforms.
When to avoid
- Your API is not HTTP/REST based (e.g., gRPC, GraphQL, or binary protocols).
- You require a lightweight, ad‑hoc description format without strict schema validation.
- You need a proprietary or highly customized API contract that cannot be expressed in OpenAPI.
Facets
framework · maturity active
api-framework http-server documentation web-development backend cross-platform cli openapi specification yaml json rest api-description web-server
8 sources
- readme: https://github.com/OAI/OpenAPI-Specification · fetched 2026-09-23 · 0f4a35c47bfa
- homepage: https://openapis.org · fetched 2026-09-21 · f7c86dec7765
- site_page: https://www.openapis.org/about · fetched 2026-09-21 · 8a852c2d6946
- site_page: https://www.openapis.org/about/technical-developer-community · fetched 2026-09-21 · 8dfa9e58a87c
- site_page: https://www.openapis.org/get-involved/about · fetched 2026-09-21 · 8c0f250b7d06
- site_page: https://learn.openapis.org · fetched 2026-09-21 · a411d595c0ad
- site_page: https://www.openapis.org/membershipjoin · fetched 2026-09-21 · 0e611d74261d
- site_page: https://www.openapis.org/faq · fetched 2026-09-21 · 72c6eb02405d
Member repositories
| Repository | Role | Health v2 |
|---|---|---|
| OAI/OpenAPI-Specification | main | 88 |
| OAI/learn.openapis.org | docs | 75 |
For agents
markdown · JSON · MCP: product_card(name="OAI/OpenAPI-Specification")
Data as of 2026-10-19T08:05:51.212177+00:00 · Report a problem