Endpoints Overview

All API endpoints are served from the base URL:

https://api.enconvert.com

This page provides a complete listing of every endpoint available in the Enconvert API, organized by category.


Data Format Converters

These endpoints accept file uploads via multipart/form-data and return the converted output.

Endpoint Input Output Status
POST /v1/convert/json-to-xml JSON XML Available
POST /v1/convert/xml-to-json XML JSON Available
POST /v1/convert/json-to-yaml JSON YAML Available
POST /v1/convert/yaml-to-json YAML JSON Available
POST /v1/convert/csv-to-json CSV JSON Available
POST /v1/convert/json-to-csv JSON CSV Available
POST /v1/convert/markdown-to-html Markdown HTML Available

See File Converters for detailed usage, parameters, and examples.


Document to PDF Converters

These endpoints accept file uploads via multipart/form-data and produce PDF output.

Lightweight Converters:

Endpoint Input Output Status
POST /v1/convert/html-to-pdf HTML PDF Available
POST /v1/convert/markdown-to-pdf Markdown PDF Available

See File Converters for detailed usage, parameters, and examples.

Office & Document Converters:

Endpoint Input Output Status
POST /v1/convert/doc-to-pdf DOC, DOCX PDF Available
POST /v1/convert/excel-to-pdf XLSX, XLS PDF Available
POST /v1/convert/ppt-to-pdf PPT, PPTX PDF Available
POST /v1/convert/odt-to-pdf ODT PDF Available
POST /v1/convert/ods-to-pdf ODS PDF Available
POST /v1/convert/odp-to-pdf ODP PDF Available
POST /v1/convert/ots-to-pdf OTS PDF Available
POST /v1/convert/pages-to-pdf Pages PDF Available
POST /v1/convert/numbers-to-pdf Numbers PDF Available
POST /v1/convert/key-to-pdf Keynote PDF Available
POST /v1/convert/epub-to-pdf ePub PDF Available

See Document Converters for detailed usage, parameters, and examples.


URL Converters

These endpoints accept a JSON request body (application/json) containing one or more URLs. They support batch processing and asynchronous execution.

Endpoint Input Output Status
POST /v1/convert/url-to-pdf URL(s) PDF Available
POST /v1/convert/url-to-screenshot URL(s) PNG Available

See URL Converters for detailed usage, parameters, and Clear Capture Mode documentation.


Website Capture

These endpoints discover all pages of a website via sitemap.xml and convert them into a ZIP archive. Always asynchronous. Requires a paid plan.

Endpoint Input Output Status
POST /v1/convert/website-to-pdf Website URL ZIP of PDFs Available
POST /v1/convert/website-to-screenshot Website URL ZIP of PNGs Available

See Website Capture for detailed usage, parameters, and sitemap requirements.


Media Converters

Coming Soon: All media conversion endpoints are under development and currently return 503 Service Unavailable.
Endpoint Description Status
POST /v1/convert/image Convert between image formats Coming Soon
POST /v1/convert/thumbnail Generate thumbnails from images or documents Coming Soon
POST /v1/convert/video Convert between video formats Coming Soon

AI Converters

Coming Soon: All AI-powered conversion endpoints are under development and currently return 503 Service Unavailable.
Endpoint Description Status
POST /v1/convert/ocr Extract text from images and scanned documents Coming Soon
POST /v1/convert/speech-to-text Transcribe audio files to text Coming Soon
POST /v1/convert/text-to-speech Generate audio from text input Coming Soon

System Endpoints

Endpoint Method Description
/health GET Health check. Returns the current status of the API service.
/v1/convert/status/{job_id} GET Poll the status of an asynchronous conversion job.

Health Check

GET https://api.enconvert.com/health

Returns a simple status response indicating the API is operational. No authentication is required.

Job Status Polling

GET https://api.enconvert.com/v1/convert/status/{job_id}

Returns the current status of an async conversion job. See Batch Processing for full details on async workflows and response formats.


Authentication Endpoints

Endpoint Method Description
/v1/auth/token POST Generate an API access token.
/v1/auth/refresh POST Refresh an expired access token.
/v1/auth/verify GET Verify that a token is valid.

Widget Endpoints

Endpoint Method Description
/v1/widget/{widget_id}/config GET Retrieve configuration for an embedded widget.
/v1/widget/{widget_id}/token POST Generate a scoped token for widget usage.