# IBM/openapi-to-graphql

Translate APIs described by OpenAPI Specifications (OAS) into GraphQL

Repository: https://github.com/IBM/openapi-to-graphql
Canonical: https://ross.abutalabs.com/products/openapi-to-graphql
Homepage: https://developer.ibm.com/open/projects/openapi-to-graphql/
Language: TypeScript
License: MIT
License Family: permissive
Topics: graphql, rest-api, translation, wrapper, openapi-specification, swagger, swagger-to-graphql, oas-to-graphql, openapi-to-graphql
Archived: true
Last push: 2026-06-02T17:07:45+00:00

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

## Adoption (not part of the score)
Stars 1646, forks 218 (observed 2026-08-28T04:05:16.379212+00:00)

## What it is
A TypeScript library and CLI from IBM that translates REST APIs described by OpenAPI Specifications (OAS) or Swagger into GraphQL schemas and servers. It can be used programmatically via createGraphQLSchema or through a CLI that spins up a GraphQL server wrapping an existing API.

## Use cases
- wrap a REST API with a GraphQL interface
- generate a GraphQL schema from an OpenAPI spec
- convert swagger definitions to graphql
- expose existing microservices as a single graphql endpoint
- spin up a graphql server from an OAS  file
- add graphql subscriptions on top of a rest api

## When to choose
- you have an existing OpenAPI/Swagger-described REST API and want a GraphQL facade
- you want a quick CLI to prototype a GraphQL wrapper around a REST service
- you need to programmatically generate GraphQL schemas from OAS documents in a Node.js app

## When to avoid
- you need actively maintained software - the repo is archived and development has paused
- you want ongoing support - use the GraphQL Mesh OpenAPI handler fork instead
- your API has no OpenAPI/Swagger specification available

## Facets
- artifact type: library
- maturity: abandoned
- function: graphql, api-framework, http-server, cli
- domain: apis, web-development, backend, developer-tools
- platform: cli, cross-platform
- tags: openapi, swagger, rest-to-graphql, schema-generation, api-wrapper, typescript, nodejs

## Member repositories
- IBM/openapi-to-graphql (main) score 10

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:16.379212+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-30T03:45:21.953311+00:00, confidence not recorded.
  - readme: https://github.com/IBM/openapi-to-graphql (fetched 2026-08-28T04:05:16.379212+00:00, sha 5640122dbc4d)
  - homepage: https://developer.ibm.com/open/projects/openapi-to-graphql/ (fetched 2026-08-29T11:18:50.065274+00:00, sha 21e1ac5a8c18)
  - registry_npm: https://registry.npmjs.org/openapi-to-graphql (fetched 2026-08-29T11:18:50.074529+00:00, sha eda9862608a5)
- Data as of 2026-08-30T08:39:29.467469+00:00.