API Documentation

Integrate powerful file conversion into your application with our RESTful API

Get StartedkeyGet API Key
bolt

Lightning Fast

High-performance conversion with optimized processing

shield

Secure & Reliable

Enterprise-grade security with 99.9% uptime

trending_up

Scalable

From prototype to production, we scale with you

terminalGetting Started

To use the 1converter API, follow these simple steps:

  1. Sign up for a free account at 1converter.com
  2. Generate an API key from your dashboard
  3. Start making API requests with your API key

keyAuthentication

All API requests must include your API key in the Authorization header:

X-API-Key: YOUR_API_KEY Authorization: Bearer YOUR_API_KEY

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

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

Base URL

All API requests should be made to:

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

OpenAPI 3.1 specification (JSON)

codeAPI Endpoints

Upload & Convert

Upload a file and convert it to the specified format

POST/api/v1/convert/upload

Request Headers

Content-Type: multipart/form-data
Authorization: Bearer YOUR_API_KEY

Request Body

  • The file to convert (required)
  • Target format (e.g., 'pdf', 'jpg', 'png') (required)

Response

{
  "id": 4821,
  "original_file_name": "document.pdf",
  "original_format": "pdf",
  "target_format": "docx",
  "status": "pending",
  "progress": 0,
  "created_at": "2026-08-01T09:14:03Z",
  "expires_at": "2026-08-08T09:14:03Z"
}

Check Status

Check the status of a conversion

GET/api/v1/convert/status/:id

Response

{
  "conversion": {
    "id": 4821,
    "original_file_name": "document.pdf",
    "target_format": "docx",
    "status": "completed",
    "progress": 100,
    "created_at": "2026-08-01T09:14:03Z",
    "expires_at": "2026-08-08T09:14:03Z"
  }
}

Download Result

Download the converted file

GET/api/v1/convert/download/:id

Rate Limits

API requests are rate limited per minute. A paid plan is required for API access:

PlanRate Limit
FreeNot available — upgrade required
Starter5,000 requests/minute
Pro5,000 requests/minute
BusinessUnlimited

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

Error Codes

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

CodeDescription
400 Bad RequestInvalid request parameters
401 UnauthorizedInvalid or missing API key
403 ForbiddenInsufficient permissions
404 Not FoundResource not found
429 Too Many RequestsRate limit exceeded
500 Internal Server ErrorServer error, please try again

integration_instructionsCode Examples

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"

Need Help?

If you have questions or need assistance with the API, we're here to help!

support_agentContact SupportkeyManage API Keys