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.
| Endpoint | Input | Output | Status |
|---|---|---|---|
POST /v1/convert/html-to-pdf |
HTML | Available | |
POST /v1/convert/markdown-to-pdf |
Markdown | Available | |
POST /v1/convert/docx-to-pdf |
DOCX | Coming Soon | |
POST /v1/convert/xlsx-to-pdf |
XLSX | Coming Soon |
docx-to-pdf and xlsx-to-pdf currently return 503 Service Unavailable. These converters are under active development and will be available in a future release.
See File 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) | Available | |
POST /v1/convert/url-to-screenshot |
URL(s) | PNG | Available |
See URL Converters for detailed usage, parameters, and Clear Capture Mode documentation.
Media Converters
| 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
| 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. |