API Documentation
Integrate powerful file conversion into your application with our RESTful API
Lightning Fast
High-performance conversion with optimized processing
Secure & Reliable
Enterprise-grade security with 99.9% uptime
Scalable
From prototype to production, we scale with you
terminalGetting Started
To use the 1converter API, follow these simple steps:
- Sign up for a free account at 1converter.com
- Generate an API key from your dashboard
- 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_KEYNote: 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/v1codeAPI Endpoints
Upload & Convert
Upload a file and convert it to the specified format
/api/v1/convert/uploadRequest Headers
Content-Type: multipart/form-data
Authorization: Bearer YOUR_API_KEYRequest Body
Le fichier à convertir (obligatoire)Format cible (par exemple 'pdf', 'jpg', 'png') (obligatoire)
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
/api/v1/convert/status/:idResponse
{
"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
/api/v1/convert/download/:idRate Limits
Les requêtes API sont limitées par minute. Une formule payante est requise pour accéder à l'API :
| Plan | Rate Limit |
|---|---|
| Free | Non disponible — mise à niveau requise |
| Starter | 5 000 requêtes/minute |
| Pro | 5 000 requêtes/minute |
| Business | Unlimited |
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:
| Code | Description |
|---|---|
| 400 Bad Request | Invalid request parameters |
| 401 Unauthorized | Invalid or missing API key |
| 403 Forbidden | Insufficient permissions |
| 404 Not Found | Resource not found |
| 429 Too Many Requests | Rate limit exceeded |
| 500 Internal Server Error | Server 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!