API reference

A small HTTP API over the same conversion pipeline the website uses. Upload a file, get one back. Four endpoints, no SDK required.

Endpoints

• Converting a fileOne endpoint does the work. POST a file and a target format, get back a job — finished if it was quick, queued if it was not.
• Polling and downloadingA queued conversion hands you a job id. These two endpoints tell you when it is ready and give you the file.
• The format catalogueOne public, unauthenticated endpoint returns everything we convert and every route between formats. Build your interface from it rather than hardcoding a list.
• Errors and status codesErrors are JSON, always the same shape, and always carry a stable machine-readable code. Branch on the code, not on the message.