Postman to OpenAPI / Swagger
Converts a Postman Collection v2.1 JSON export to an OpenAPI 3.0 YAML spec. Extracts all endpoints, path / query / header parameters, request bodies, and folder names as tags. Nothing leaves your browser.
About This Tool
Converts a Postman Collection v2.1 export into an OpenAPI 3.0.3 YAML spec, walking folders, requests, and saved examples to rebuild paths, parameters, request bodies, and tags. Useful when a collection is the only documentation an API has, and that documentation needs to go into Swagger UI, Redoc, or a codegen pipeline.
This is the Postman → OpenAPI direction. For the reverse, use OpenAPI / Swagger to Postman.
Key Features
- Convert on edit: output regenerates as soon as the input changes, no separate run step.
- Swap direction: the ⇌ button sends the current output to the OpenAPI to Postman tool, pre-filled.
- File upload & drag-and-drop: load a
.jsoncollection export directly. - Download .yaml: saves the generated spec as
openapi.yaml. - Keyboard-driven: Cmd/Ctrl+Enter to convert, Cmd/Ctrl+Shift+C to copy the output.
- Sample collection: one click loads a 3-endpoint Users API example to see the mapping.
What gets converted
- Folders → Tags: top-level Postman folders become OpenAPI tags
- Path variables -
:idbecomes{id}with a path parameter entry - Query params: url.query items become
in: queryparameters - Headers: custom request headers become
in: headerparameters (Content-Type, Authorization, and Accept are handled structurally) - Request bodies: raw JSON, urlencoded, form-data, and GraphQL bodies are all converted with inferred schemas
- Auth: collection-level bearer / basic / API key auth becomes a
securitySchemesentry - Saved responses: example responses seed the
responsesobject
FAQ
- Which Postman collection version is supported?
- Collection v2.1 (
schema: ".../v2.1.0/collection.json"). Export from Postman via File → Export → Collection v2.1. - Does it support nested folders?
- Yes, folders are walked recursively. Only the immediate parent folder name is used as the OpenAPI tag.
- What OpenAPI version is the output?
- OpenAPI 3.0.3 YAML. Import it into Swagger UI, Redoc, Stoplight, or any OpenAPI-compatible tool.
- Can I go the other direction?
- Yes, use the OpenAPI to Postman tool.