Skip to content
HALOWERK

Formatwerk

postman to openapi

Own converter for the Postman v2.1 (and v2.0) collection format: collection variables resolve {{baseUrl}}-style servers (unresolved ones become server variables), :id segments become path parameters with examples, query and header entries become parameters with types inferred from their example values, raw JSON/urlencoded/form-data/GraphQL/file bodies become request bodies with JSON Schemas inferred from the example, saved example responses become responses per status code, folders become.

POST https://format.halowerk.com/v1/postman-to-openapi

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
collectionobjectYesPostman collection JSON (info.schema must name v2.1.0 or v2.0.0).
server_urlstringNoOptional server URL that replaces the derived servers.
versionstringNoOptional info.version.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "collection"
  ],
  "properties": {
    "collection": {
      "type": "object",
      "description": "Postman collection JSON (info.schema must name v2.1.0 or v2.0.0)."
    },
    "server_url": {
      "type": "string",
      "format": "uri",
      "maxLength": 500,
      "description": "Optional server URL that replaces the derived servers."
    },
    "version": {
      "type": "string",
      "maxLength": 50,
      "description": "Optional info.version."
    }
  }
}

Open original schema

Published input example

{
  "collection": {
    "info": {
      "name": "Users API",
      "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json",
      "description": "Warehouse inventory API"
    },
    "variable": [
      {
        "key": "baseUrl",
        "value": "https://halowerk.com/"
      }
    ],
    "auth": {
      "type": "noauth"
    },
    "item": [
      {
        "name": "Users",
        "item": [
          {
            "name": "Get user",
            "request": {
              "method": "GET",
              "url": {
                "raw": "{{baseUrl}}/users/:id?verbose=true",
                "host": [
                  "{{baseUrl}}"
                ],
                "path": [
                  "users",
                  ":id"
                ],
                "query": [
                  {
                    "key": "verbose",
                    "value": "true"
                  }
                ],
                "variable": [
                  {
                    "key": "id",
                    "value": "42"
                  }
                ]
              }
            },
            "response": [
              {
                "name": "OK",
                "code": 200,
                "status": "OK",
                "header": [
                  {
                    "key": "Content-Type",
                    "value": "application/json"
                  }
                ],
                "body": "{\"id\":42,\"name\":\"Ada\"}"
              }
            ]
          },
          {
            "name": "Create user",
            "request": {
              "method": "POST",
              "header": [
                {
                  "key": "Content-Type",
                  "value": "application/json"
                }
              ],
              "body": {
                "mode": "raw",
                "raw": "{\"name\":\"Ada\",\"age\":36}",
                "options": {
                  "raw": {
                    "language": "json"
                  }
                }
              },
              "url": {
                "raw": "{{baseUrl}}/users",
                "host": [
                  "{{baseUrl}}"
                ],
                "path": [
                  "users"
                ]
              }
            }
          }
        ]
      },
      {
        "name": "Health",
        "request": {
          "method": "GET",
          "auth": {
            "type": "noauth"
          },
          "url": "{{baseUrl}}/health"
        }
      }
    ]
  }
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub โ†’