# Swagger2OpenAPI Converter API

> Swagger2OpenAPI Converter API on Apizie: 6 endpoints (Return a redirect to a badge svg file depending on a source definition's validity, Convert a Swagger 2.0 definition to OpenAPI 3.0.x from a URL, Convert a Swagger 2.0 definition passed in the body to OpenAPI 3.0.x, Get the status of the API, …) returned as clean JSON through one API key. 6 endpoints are live now. Call it over REST at https://zieapi.vercel.app/v1/dev-tools:mermade-org-uk-openapi-converter/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `dev-tools:mermade-org-uk-openapi-converter`
- Category: Dev Tools
- Status: live
- Source: https://github.com/mermade/swagger2openapi/issues
- Page: https://zieapi.vercel.app/api/dev-tools/mermade-org-uk-openapi-converter
- OpenAPI: https://zieapi.vercel.app/api/dev-tools/mermade-org-uk-openapi-converter/openapi.json

Converter and validator for Swagger 2.0 to OpenAPI 3.0.x definitions

## Endpoints

### Return a redirect to a badge svg file depending on a source definition's validity
`GET https://zieapi.vercel.app/v1/dev-tools:mermade-org-uk-openapi-converter/get-badge`

| Parameter | Type | Required | Description |
|---|---|---|---|
| url | string | yes | The URL to retrieve the OpenAPI 3.0.x definition from |

### Convert a Swagger 2.0 definition to OpenAPI 3.0.x from a URL
`GET https://zieapi.vercel.app/v1/dev-tools:mermade-org-uk-openapi-converter/convert-url`

| Parameter | Type | Required | Description |
|---|---|---|---|
| url | string | yes | The URL to retrieve the OpenAPI 2.0 definition from |

### Convert a Swagger 2.0 definition passed in the body to OpenAPI 3.0.x
`POST https://zieapi.vercel.app/v1/dev-tools:mermade-org-uk-openapi-converter/convert`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | Form fields as a JSON object |

### Get the status of the API
`GET https://zieapi.vercel.app/v1/dev-tools:mermade-org-uk-openapi-converter/get-status`

### Validate an OpenAPI 3.0.x definition
`GET https://zieapi.vercel.app/v1/dev-tools:mermade-org-uk-openapi-converter/validate-url`

| Parameter | Type | Required | Description |
|---|---|---|---|
| url | string | yes | The URL to retrieve the OpenAPI 3.0.x definition from |

### Validate an OpenAPI 3.0.x definition supplied in the body of the request
`POST https://zieapi.vercel.app/v1/dev-tools:mermade-org-uk-openapi-converter/validate`

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | Form fields as a JSON object |

## Example
```
curl "https://zieapi.vercel.app/v1/dev-tools:mermade-org-uk-openapi-converter/get-badge" \
  -H "x-api-key: $APIZIE_KEY"
```

## FAQ

### How do I call the Swagger2OpenAPI Converter API?
Create a free Apizie key, then send GET https://zieapi.vercel.app/v1/dev-tools:mermade-org-uk-openapi-converter/get-badge with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Swagger2OpenAPI Converter API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card.

### Can AI agents use the Swagger2OpenAPI Converter API?
Yes. Add the Apizie MCP server (https://zieapi.vercel.app/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key dev-tools:mermade-org-uk-openapi-converter.

### What is the status of the Swagger2OpenAPI Converter API?
Live: works with just an Apizie key