OAI/OpenAPI-Specification resource
The OpenAPI Specification Repository observed · 2026-08-28
Health v2 · maintenance only
81/100
- Activity 99
- Release rhythm 48
- Longevity 100
How is this computed?
round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10) — computed 2026-09-03. Adoption (stars, forks) is never an input.
- gap_med: 0
- age_days: 4566
- days_rel: 348
- days_push: 7
- n_releases_24m: 4
Adoption not part of the score
31183 stars · 9165 forks observed · 2026-08-28
What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-29, confidence not recorded
The official repository for the OpenAPI Specification (OAS), a vendor-neutral, language-agnostic standard for describing HTTP/REST APIs in YAML or JSON. It hosts the Markdown sources of all published spec versions under the Linux Foundation's OpenAPI Initiative, alongside related specs like Arazzo and Overlays.
Use cases
- describe a REST API in a machine-readable format
- generate client SDKs and server stubs from an API definition
- generate interactive API documentation
- validate and lint API description files
- automate API test cases from a spec
- learn how to write OpenAPI descriptions
- adopt a design-first API development workflow
When to choose
- you need the authoritative source for OpenAPI spec versions and release notes
- you want a widely supported, vendor-neutral standard for describing HTTP APIs
- you want tooling interoperability for docs, codegen, and testing built on one description format
When to avoid
- you need a tool or library that parses or validates OpenAPI files rather than the spec itself
- you need to describe non-HTTP APIs or styles outside REST that OAS does not cover
- you want a ready-made implementation rather than a specification document
Facets
learning-resource · maturity active
api-documentation documentation sdk testing apis web-development developer-tools documentation cross-platform openapi swagger rest api-description specification yaml json code-generation design-first
8 sources
- readme: https://github.com/OAI/OpenAPI-Specification · fetched 2026-08-28 · 0f4a35c47bfa
- homepage: https://openapis.org · fetched 2026-08-29 · f7c86dec7765
- site_page: https://www.openapis.org/about · fetched 2026-08-29 · 8a852c2d6946
- site_page: https://www.openapis.org/about/technical-developer-community · fetched 2026-08-29 · 8dfa9e58a87c
- site_page: https://www.openapis.org/get-involved/about · fetched 2026-08-29 · 8c0f250b7d06
- site_page: https://learn.openapis.org · fetched 2026-08-29 · a411d595c0ad
- site_page: https://www.openapis.org/membershipjoin · fetched 2026-08-29 · 0e611d74261d
- site_page: https://www.openapis.org/faq · fetched 2026-08-29 · 72c6eb02405d
Member repositories
| Repository | Role | Health v2 |
|---|---|---|
| OAI/OpenAPI-Specification | main | 81 |
For agents
markdown · JSON · MCP: product_card(name="OAI/OpenAPI-Specification")
Data as of 2026-08-30T08:39:29.467469+00:00 · Report a problem