API Endpoints

API Version 2.1.0 - Latest Changes

What's New in v2.1.0

AI-ready markdown output
Direct file upload support
Batch processing capabilities
Advanced OCR processing

Base URL

https://api.markdownconverters.com/api/v1

Authentication

Required Header

X-API-Key: your-api-key

Include your API key in the X-API-Key header for all requests. Get your API key at app.markdownconverters.com.

Endpoints Overview

File Conversion

Core Endpoint

/api/v1/convert

Convert single files to Markdown with Base64 or URL input

POST

Batch Conversion

Core Endpoint

/api/v1/batch

Convert multiple files in a single request

POST

Conversion Status

/api/v1/status/{jobId}

Check the status of your conversion job

GET

Batch Status

/api/v1/batch/{batchId}

Check the status of your batch conversion

GET

Usage Statistics

/api/v1/usage

View your API usage and quota information

GET

Extend SAS Token

/api/v1/extend-sas

Extend the expiry time of SAS URLs

POST

Health Check

/api/v1/health

Check system health and status

GET

Supported File Formats

Documents

.pdf.docx.pptx.xlsx

Full text extraction

Web

.html.htm

Preserves structure

Images

.jpg.jpeg.png.gif

OCR text extraction

Audio

.wav.mp3

Transcription to text

Data

.csv.json.xml

Structured data conversion

Text

.txt.md.epub.msg

Direct conversion

Detailed Endpoint Reference

File Conversion

POST /api/v1/convertPOST

Convert a single file to AI-ready Markdown format. Supports both Base64 file content and URL-based conversion.

Batch Conversion

POST /api/v1/batchPOST

Convert multiple files in a single request. Efficient processing with consolidated results.

Conversion Status

GET /api/v1/status/{jobId}GET

Check the status of your conversion job using the job ID returned from the conversion request.

Batch Status

GET /api/v1/batch/{batchId}GET

Check the status of your batch conversion using the batch ID returned from the batch request.

Usage Statistics

GET /api/v1/usageGET

View your API usage statistics including requests made, quota limits, and remaining credits.

Extend SAS Token

POST /api/v1/extend-sasPOST

Extend the expiry time of SAS (Shared Access Signature) URLs for file downloads.

Health Check

GET /api/v1/healthGET

Check the health status of the API service. Returns system status and availability information.