# swagger-api/swagger-core

Examples and server integrations for generating the Swagger API Specification, which enables easy access to your REST API

Repository: https://github.com/swagger-api/swagger-core
Canonical: https://ross.abutalabs.com/products/swagger-core
Homepage: http://swagger.io
Language: Java
License: Apache-2.0
License Family: permissive
Topics: swagger, java, swagger-api, rest-api, rest, openapi-specification, openapi, openapi3, open-source, swagger-oss, hacktoberfest
Last push: 2026-08-26T17:33:06+00:00

## Health v2 (maintenance only)
Score: 99/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 98, longevity 100
- inputs: {"age_days": 5538, "days_push": 7, "days_rel": 15, "gap_med": 16.0, "n_releases_24m": 33}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 7531, forks 2263 (observed 2026-08-28T04:10:00.589820+00:00)

## What it is
Swagger Core is a Java library that implements the OpenAPI Specification, generating OpenAPI 3.x definitions from JAX-RS (javax and jakarta) REST APIs. It provides annotations, serializers, and integrations for producing Swagger/OpenAPI documentation from Java code.

## Use cases
- generate openapi spec from java rest api
- document jax-rs endpoints with annotations
- produce openapi 3.1 definitions from code
- add swagger documentation to a java backend
- serialize openapi models to yaml or

## When to choose
- you have a Java JAX-RS REST API and want OpenAPI documentation generated from annotations
- you need OpenAPI 3.x or 3.1 support in the JVM ecosystem
- you want javax and jakarta namespace compatibility

## When to avoid
- your API is not on the JVM or not JAX-RS based
- you need a full API design or documentation portal product rather than a spec-generation library
- you only need OpenAPI 2.0 tooling without the 1.5 branch

## Facets
- artifact type: library
- maturity: stable
- function: api-framework, api-documentation, serialization
- domain: apis, web-development, backend, documentation, developer-tools
- platform: jvm, cross-platform
- tags: openapi, openapi3, swagger, jax-rs, rest-api, api-specification, jakarta

## Member repositories
- swagger-api/swagger-core (main) score 99

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:10:00.589820+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:37:27.100231+00:00, confidence not recorded.
  - readme: https://github.com/swagger-api/swagger-core (fetched 2026-08-28T04:10:00.589820+00:00, sha 2edbf5501dc9)
  - homepage: http://swagger.io (fetched 2026-08-29T08:32:33.228706+00:00, sha 4f1f57a23ce3)
  - site_page: https://swagger.io/docs (fetched 2026-08-29T08:32:33.232796+00:00, sha bc9e768d7742)
  - site_page: https://swagger.io/product/portal (fetched 2026-08-29T08:32:33.231102+00:00, sha a39114d3b402)
- Data as of 2026-08-30T08:39:29.467469+00:00.