API documentation

From zero to the first converted file:

1. Choose a paid plan (Starter, Pro or Business) on 1-converter.com. API keys are not available on Free.
2. Create a key in Dashboard → Settings → API keys and copy it: it is shown only once.
3. Send the key with your first upload, as shown under Authentication.

Send your API key with every request, in either of these two headers:

X-API-Key: YOUR_API_KEY

Authorization: Bearer YOUR_API_KEY

Both headers are accepted and carry the same key, so use whichever your HTTP client makes easier.

Never share your API key or commit it to version control.

Keep your API key secure and never expose it in client-side code.

All API requests should be made to:

https://api.1-converter.com/api/v1

OpenAPI 3.1 (openapi.json)

Each paid plan includes a monthly number of API calls, the same allowance shown on the pricing page.

When rate limits are exceeded, you'll receive a 429 Too Many Requests response.

The API uses standard HTTP status codes to indicate success or failure:

Here are examples in different programming languages:

JavaScript (Node.js)

const FormData = require('form-data');
const fs = require('fs');
const axios = require('axios');

const formData = new FormData();
formData.append('file', fs.createReadStream('input.jpg'));
formData.append('target_format', 'png');

axios.post('https://api.1-converter.com/api/v1/convert/upload', formData, {
  headers: {
    ...formData.getHeaders(),
    'Authorization': 'Bearer YOUR_API_KEY'
  }
}).then(response => {
  console.log(response.data);
}).catch(error => {
  console.error(error);
});

Python

import requests

url = 'https://api.1-converter.com/api/v1/convert/upload'
headers = {'Authorization': 'Bearer YOUR_API_KEY'}
files = {'file': open('input.jpg', 'rb')}
data = {'target_format': 'png'}

response = requests.post(url, headers=headers, files=files, data=data)
print(response.json())

cURL

curl -X POST https://api.1-converter.com/api/v1/convert/upload \
  -H "X-API-Key: YOUR_API_KEY" \
  -F "[email protected]" \
  -F "target_format=png"