Learn how to upload files, convert them, and download the results.
The OrbConvert conversion pipeline has three steps: Upload, Convert, Download.
Submit a conversion request with your file and target format:
# 1. Upload the file
curl -X POST https://api.orbconvert.com/api/uploads \
-H "x-api-key: ch_live_your_api_key_here" \
-F "file=@presentation.pptx"
# Response: { "file": { "fileId": "file_abc123" } }
# 2. Start the conversion
curl -X POST https://api.orbconvert.com/api/conversions \
-H "x-api-key: ch_live_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{"fileId": "file_abc123", "toFormat": "pdf"}'
# Response: { "conversionId": "conv_xyz789" }Response:
{
"conversionId": "conv_xyz789"
}Poll the conversion endpoint to check progress:
curl -X GET https://api.orbconvert.com/api/conversions/conv_xyz789 \ -H "x-api-key: ch_live_your_api_key_here"
Convert multiple files in a single request:
curl -X POST https://api.orbconvert.com/api/conversions/batch \
-H "x-api-key: ch_live_your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"items": [
{ "fileId": "file_abc123", "toFormat": "jpg" },
{ "fileId": "file_def456", "toFormat": "jpg" },
{ "fileId": "file_ghi789", "toFormat": "jpg" }
]
}'OrbConvert supports 100+ format pairs across verified categories:
Documents
PDF to DOCX, DOC, RTF, TXT, HTML, EPUB, PNG, JPG; Office (DOCX, PPTX, XLSX) to PDF
Images
JPG, JPEG, PNG, WEBP, GIF, SVG, TIFF → AVIF, BMP, GIF, ICO, JPG, PNG, TIFF, WEBP (+PDF)
Vectors
SVG to PNG, JPG, WEBP, TIFF, PDF, DXF
CAD
DXF to SVG, PDF; SVG to DXF, PDF
Ebooks
EPUB to PDF, TXT, HTML; TXT/HTML/PDF to EPUB
Video
MP4, AVI, MOV, MKV, WEBM → MP4, AVI, MOV, MKV, WEBM, GIF, FLV, WMV, 3GP
Audio
MP3, WAV, FLAC, AAC, OGG → MP3, WAV, FLAC, AAC, OGG, M4A, WMA, OPUS, AIFF
Archives
ZIP, RAR, 7Z, TAR, GZ → ZIP, TAR, TAR.GZ (RAR/7Z are refused by design: no native extractor)
SAME_FORMAT). To optimize or compress files without format changes, use our dedicated optimization tools or pass applicable options (e.g. stripMetadata).| Plan | Max File Size | Batch Limit | Daily Data Quota |
|---|---|---|---|
| Guest | 25 MB | 2 files | 250 MB / day |
| Free | 100 MB | 5 files | 1 GB / day |
| Pro | 2 GB | 10 files | 3 GB / day |
| Business | 5 GB | 20 files | 10 GB / day |
Was this page helpful?