API Reference

Integrate MiConvert's powerful file conversion engine into your own applications or AI Agents.

Introduction

The MiConvert API is a RESTful service that provides access to our core conversion engine. It supports over 1,000+ file format combinations spanning images, documents, audio, video, 3D models, and archives.

Our API is built for both human developers building traditional applications and AI Agents (like ChatGPT) executing tasks autonomously.

Marketplace API Free tier

The production API is sold through RapidAPI. Subscribe there to get a key: the BASIC plan is free (50 requests a month). Billing, keys and quotas are handled by RapidAPI. The OpenAPI 3 definition is at /openapi-marketplace.yaml.

It covers more than 1,000 conversion pairs, including the ones generic converters lack: 3D and CAD (STEP, IGES, FCStd, STL, OBJ, GLB, 3MF, DWG to DXF/PDF), OFD e-invoices to PDF, and Wwise WEM game audio.

curl -X POST "https://miconvert-file-converter.p.rapidapi.com/convert?wait=30" \
  -H "X-RapidAPI-Key: YOUR_RAPIDAPI_KEY" \
  -H "X-RapidAPI-Host: miconvert-file-converter.p.rapidapi.com" \
  -F "[email protected]" \
  -F "to=stl"

Files above 50 MB go by file_url. Uploaded and converted files are deleted automatically.

MCP Server No sign-in

MiConvert is available to AI assistants as a remote Model Context Protocol server. Add it to Claude, ChatGPT, Cursor, VS Code or any MCP client and ask the assistant to convert a file by link.

https://miconvert.com/mcp

Transport: Streamable HTTP. No API key or account is needed.

Add it to your assistant

• Claude (claude.ai and Claude Desktop): Settings → Connectors → Add custom connector, then paste the URL.
• Claude Code: claude mcp add --transport http miconvert https://miconvert.com/mcp
• ChatGPT: Settings → Apps & Connectors → Advanced → Developer mode, then create a connector with the URL.
• Cursor, VS Code, Windsurf and other clients that read an mcpServers config:

{
  "mcpServers": {
    "miconvert": { "url": "https://miconvert.com/mcp" }
  }
}

Tools

Example prompt: "Convert https://example.com/invoice.ofd to PDF with MiConvert."

The assistant must be able to reach the file by URL: files attached to a chat or stored on your computer are not sent to MCP servers. Limits: one file of up to 50 MB per call, and a shared hourly allowance per connection. Files are deleted automatically after conversion; see the privacy policy. Questions: contact us.

Authentication

Authenticate your API requests by including your secret API key in the `Authorization` HTTP header. You can obtain an API key from the Developer Dashboard.

Authorization: Bearer YOUR_API_KEY

If you don't provide an API key, you will be subject to our strict public rate limits and file size restrictions.

Rate Limits & Quotas

API limits depend on your current pricing plan:

AI Agent Integration New

MiConvert is fully optimized for Agentic workflows (ChatGPT Search, Claude, Gemini, etc). AI Agents generally cannot easily handle multipart/form-data uploads. Therefore, our API accepts direct URL inputs via standard JSON.

You can view the strict OpenAPI specification here: /openapi.json

Attribution Rules Required

To ensure fairness and transparency, apps and services that show results from this API must credit MiConvert.

Each conversion response also carries an attribution field with this credit, so an app can show it next to the result.

POST /api/convert

Creates a new conversion job. You can send the file via two methods: a direct URL (recommended for AI) or a raw file upload.

Method 1: Direct URL (JSON) - AI Preferred

Send a standard application/json payload.

{
  "file_url": "https://example.com/image.png",
  "from": "png",
  "to": "webp"
}

Method 2: Form Upload (Multipart)

Send a multipart/form-data payload.

curl -X POST https://miconvert.com/api/convert \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "files=@local_image.png" \
  -F "from=png" \
  -F "to=webp"

Response

The API is asynchronous. You will receive a jobId immediately.

{
  "success": true,
  "jobId": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
  "message": "1 file(s) queued for conversion"
}

GET /api/status/{jobId}

Poll this endpoint to check the status of your conversion job. We recommend polling every 2 seconds.

Response (Pending)

{
  "status": "processing",
  "progress": 45,
  "files": []
}

Response (Completed)

{
  "status": "completed",
  "progress": 100,
  "files": [
    {
      "originalName": "image.webp",
      "downloadUrl": "https://miconvert.com/api/download/f47ac10b-58cc.../image.webp",
      "size": 102450
    }
  ]
}