# APIDevTools/swagger-parser

Swagger 2.0 and OpenAPI 3.0 parser/validator

Repository: https://github.com/APIDevTools/swagger-parser
Canonical: https://ross.abutalabs.com/products/swagger-parser
Homepage: http://apidevtools.com/swagger-parser/
Language: JavaScript
License: MIT
License Family: permissive
Topics: swagger, openapi, rest-api, json-schema, parser, resolver, validator, validation, nodejs, javascript, universal-javascript, openapi3
Last push: 2026-09-02T16:29:50+00:00

## Health v2 (maintenance only)
Score: 96/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 100, release rhythm 88, longevity 100
- inputs: {"age_days": 4335, "days_push": 0, "days_rel": 0, "gap_med": 64.5, "n_releases_24m": 5}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1205, forks 171 (observed 2026-09-03T02:15:00.504602+00:00)

## What it is
A JavaScript library that parses, validates, resolves, bundles, and dereferences Swagger 2.0 and OpenAPI 3.0 specifications in JSON or YAML. It handles $ref pointers including external files, URLs, and circular references, and works in both Node.js and browsers.

## Use cases
- validate an openapi spec against the schema
- parse swagger yaml files in node
- resolve $ref pointers across external files
- bundle multi-file openapi specs into one file
- dereference openapi spec into a plain javascript object
- lint and validate api definitions in ci

## When to choose
- you need to parse or validate Swagger 2.0 / OpenAPI 3.0 documents in JavaScript
- your specs use external or circular $ref references
- you want a battle-tested parser validated against 1,500+ real-world APIs

## When to avoid
- you need OpenAPI 3.1 support
- you are parsing non-OpenAPI JSON Schema documents
- you work outside the JavaScript ecosystem

## Facets
- artifact type: library
- maturity: active
- function: parser, serialization, developer-tools
- domain: apis, developer-tools, parsers
- platform: browser, cross-platform
- tags: openapi, swagger, -schema, ref-resolution, api-spec-validation, yaml, nodejs, javascript

## Member repositories
- APIDevTools/swagger-parser (main) score 96

## Provenance
- Observed fields: from GitHub, fetched 2026-09-03T02:15:00.504602+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-30T06:19:19.826553+00:00, confidence not recorded.
  - readme: https://github.com/APIDevTools/swagger-parser (fetched 2026-09-03T02:15:00.504602+00:00, sha 0d0e4999c6e0)
  - homepage: http://apidevtools.com/swagger-parser/ (fetched 2026-08-29T12:27:16.650890+00:00, sha dd389fc97fc4)
  - registry_npm: https://registry.npmjs.org/swagger-parser (fetched 2026-08-29T12:27:16.660072+00:00, sha c79e60c01c61)
- Data as of 2026-08-30T08:39:29.467469+00:00.