HotConvert — Convert your files in seconds

Your API key

POST/converter/convert

Convert a file

Converts an uploaded file to the specified target format. Authenticated users with a paid plan consume their monthly quota; free users consume daily quota. Anonymous users (no token) consume conversions tracked by session.

Parameters

Name	In	Type	Required	Description
file	form	file	required	The file to convert (multipart/form-data)
targetFormat	form	string	required	Target format (e.g. pdf, png, mp4)
sourceFormat	form	string	optional	Source format — detected from filename if omitted
Authorization	header	string	optional	Bearer token (optional — increases quota limit)
X-Session-ID	header	string	optional	Anonymous session UUID for quota tracking

Code examples

curl -X POST "https://api.hotconvert.com/converter/convert" \
  -F "file=@your_file.docx" \
  -F "targetFormat=pdf"

Example response

{
  "success": true,
  "message": "File successfully converted",
  "data": {
    "convertedFileUrl": "https://api.hotconvert.com/converter/files/abc123.pdf",
    "conversionId": "abc123",
    "fileSize": 48230,
    "quota": {
      "allowed": true,
      "used": 1,
      "limit": 15,
      "type": "free",
      "period": "day"
    }
  }
}

Try it live

file*file

The file to convert (multipart/form-data)

targetFormat*string

Target format (e.g. pdf, png, mp4)

sourceFormatstring

Source format — detected from filename if omitted

X-Session-IDstring