---
title: "API reference"
description: "Every operation of the markitdown.ai API v1 (37 endpoints), generated from the OpenAPI 3.1 document, with a playground on each page."
url: https://markitdown.ai/docs/api
updated: 2026-09-26
source: markitdown.ai
---

# API reference

> Every operation of the markitdown.ai API v1 (37 endpoints), generated from the OpenAPI 3.1 document, with a playground on each page.

## What is in this reference?

Base URL `https://api.markitdown.ai/v1`. Each page below is generated from `https://api.markitdown.ai/openapi.json` (version 2.0.0) and lists the parameters, request body and responses of one operation. The per-format estimate endpoints share one page, and every error code is in one table at `/docs/errors`. Hand-written guides live under Documentation.

- [Error codes](/docs/errors) — problem+json catalog
- [Guides](/docs) — authentication, quickstart, webhooks

## Convert

- **POST** [/v1/convert/excel](/docs/api/convert-excel) — Convert Excel to Markdown
- **POST** [/v1/convert/html](/docs/api/convert-html) — Convert HTML to Markdown
- **POST** [/v1/convert/image](/docs/api/convert-image) — Convert an image to Markdown
- **POST** [/v1/convert/markdown/html](/docs/api/convert-markdown-html) — Convert Markdown to HTML
- **POST** [/v1/convert/markdown/text](/docs/api/convert-markdown-text) — Convert Markdown to plain text
- **POST** [/v1/convert/pdf](/docs/api/convert-pdf) — Convert PDF to Markdown
- **POST** [/v1/convert/powerpoint](/docs/api/convert-powerpoint) — Convert PowerPoint to Markdown
- **POST** [/v1/convert/text](/docs/api/convert-text) — Convert text to Markdown
- **POST** [/v1/convert/url](/docs/api/convert-url) — Convert a web page to Markdown
- **POST** [/v1/convert/word](/docs/api/convert-word) — Convert Word to Markdown
- **POST** [/v1/convert/{name}/estimate](/docs/api/estimates) — Estimate credits for any conversion

## Conversions

- **GET** [/v1/conversions](/docs/api/list-conversions) — List conversions
- **GET** [/v1/conversions/{id}](/docs/api/get-conversion) — Get a conversion
- **DELETE** [/v1/conversions/{id}](/docs/api/delete-conversion) — Delete a conversion and its files
- **GET** [/v1/conversions/{id}/events](/docs/api/get-conversion-events) — Server-Sent Events progress stream
- **GET** [/v1/conversions/{id}/files](/docs/api/list-conversion-files) — List a conversion's source files (with their outputs)
- **GET** [/v1/conversions/{id}/files/{file_id}](/docs/api/get-conversion-file) — Get one file
- **GET** [/v1/conversions/{id}/files/{file_id}/content](/docs/api/get-conversion-file-content) — Download a file's content (source preview or output body)
- **POST** [/v1/conversions/{id}/files/{file_id}/retry](/docs/api/retry-conversion-file) — Retry a failed source file

## Uploads

- **POST** [/v1/uploads](/docs/api/create-upload) — Start a chunked upload
- **GET** [/v1/uploads/{id}](/docs/api/get-upload) — Upload status, for resuming
- **DELETE** [/v1/uploads/{id}](/docs/api/delete-upload) — Abort an upload
- **POST** [/v1/uploads/{id}/complete](/docs/api/complete-upload) — Complete a chunked upload

## Webhooks

- **POST** [/v1/webhooks](/docs/api/create-webhook) — Create a webhook endpoint
- **GET** [/v1/webhooks](/docs/api/list-webhooks) — List outbound webhook endpoints
- **DELETE** [/v1/webhooks/{id}](/docs/api/delete-webhook) — Delete a webhook endpoint

## Formats

- **GET** [/v1/formats](/docs/api/get-formats) — The accepted input/option matrix per convert name

## Usage

- **GET** [/v1/usage](/docs/api/get-usage) — Credit balance, plan and recent conversions

## Related

- [Error codes](https://markitdown.ai/docs/errors)
- [Introduction](https://markitdown.ai/docs)
- [Document Conversion APIs](https://markitdown.ai/developers)