Which Swagger versions?

OpenAPI 2 (formerly Swagger 2.0) and OpenAPI 3.x. The tool auto-detects and converts appropriately.

What's in the generated Collection?

One request per endpoint, with method, URL, headers, and example body from the spec. Variables for the base URL and auth.

Does it preserve examples?

Yes — if the OpenAPI has `examples` sections, they become the default request body. Multiple examples become multiple requests in the collection.

Can I edit after conversion?

Yes — the output is plain JSON you can import into REST Handler, Postman, Insomnia, or Bruno. Edit before or after import.

Swagger to Collection JSON

DevTools Surf

Example: Swagger to Collection JSON

A worked example, rendered from real sample data. Sign in to run the tool on your own input.

Input

{"openapi":"3.0.0","info":{"title":"User API","version":"1.0"},"servers":[{"url":"https://api.example.com"}],"paths":{"/users":{"get":{"summary":"List users"},"post":{"summary":"Create user"}},"/users/{id}":{"get":{"summary":"Get user"},"delete":{"summary":"Delete user"}}}}

Output

{
  "info": {
    "_postman_id": "user-api-1-0",
    "name": "User API 1.0",
    "description": "Generated from OpenAPI 3.0.0",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "item": [
    {
      "name": "default",
      "item": [
        {
          "name": "List users",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/users",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "users"
              ],
              "query": [],
              "variable": []
            },
            "description": "List users"
          },
          "response": []
        },
        {
          "name": "Create user",
          "request": {
            "method": "POST",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/users",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "users"
              ],
              "query": [],
              "variable": []
            },
            "description": "Create user"
          },
          "response": []
        },
        {
          "name": "Get user",
          "request": {
            "method": "GET",
            "header": [],
            "url": {
              "raw": "{{baseUrl}}/users/{id}",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "users",
                ":id"
              ],
              "qu
…

About Swagger to Collection JSON

Swagger to Collection JSON preview - API / Config tool

Convert an OpenAPI / Swagger spec into a Collection JSON v2.1 payload. Part of the DevTools Surf developer suite. Browse more tools in the API / Config collection.

Use Cases

Import API specs into Postman for interactive testing
Generate API test collections from Swagger documentation
Share runnable API collections with QA teams
Convert OpenAPI specs for use in automated API testing pipelines

Tips

Upload a Swagger/OpenAPI spec to get Collection JSON output
Use the collection to import endpoints into API testing tools
Verify all endpoints are included after conversion

Fun Facts

Collection JSON v2.1, used by Postman, can represent complex request chains including pre-request scripts and test assertions.
Postman was created by Abhinav Asthana in 2012 as a Chrome extension and grew to over 30 million users by 2023.
The OpenAPI-to-Postman converter must handle parameter serialization styles (matrix, label, form) that differ between the two formats.

FAQ

Which Swagger versions?: OpenAPI 2 (formerly Swagger 2.0) and OpenAPI 3.x. The tool auto-detects and converts appropriately.
What's in the generated Collection?: One request per endpoint, with method, URL, headers, and example body from the spec. Variables for the base URL and auth.
Does it preserve examples?: Yes — if the OpenAPI has `examples` sections, they become the default request body. Multiple examples become multiple requests in the collection.
Can I edit after conversion?: Yes — the output is plain JSON you can import into REST Handler, Postman, Insomnia, or Bruno. Edit before or after import.

Related API / Config Tools

REST Handler OpenAPI Viewer package.json Analyzer Dockerfile Linter Kubernetes Manifest Validator Mock Server Config Generator API Request Builder GraphQL Explorer