Getting Started

A single REST API to convert HTML, images, spreadsheets, and data files.

Overview

The FileSwitch API converts files between supported formats. Upload a file as multipart/form-data, and the API returns a Conversion object with a temporary download URL. Every request goes to a versioned base URL:

Base URLbash

https://api.fileswitch.co/api/v1

Authentication

Two kinds of credentials can authenticate requests: API keys for programmatic access to the conversion API and JWT access tokens for account endpoints (login, billing, history, API key management). API keys are available on paid plans and inherit the same rate limits, concurrency, and credit rules as your account. See the Authentication guide for the full details.

Quick start

Create a free account and upgrade to a paid plan.
Create an API key in the Integrations tab.
Make your first conversion:

First conversion

curl -X POST https://api.fileswitch.co/api/v1/converter/html-to-pdf \
  -H "Authorization: Bearer fc_YOUR_API_KEY" \
  -F "file=@report.html"

Every conversion is an endpoint

Each conversion has its own endpoint — POST /converter/:slug — so it can accept conversion-specific options alongside the file. Browse the conversion API reference to pick the endpoint you need and copy a ready-to-use request in any language.