---
title: "Server-Sent Events progress stream"
description: "GET https://api.markitdown.ai/v1/conversions/{id}/events — Server-Sent Events progress stream. Authenticate with x-api-key."
url: https://markitdown.ai/docs/api/get-conversion-events
updated: 2026-09-26
source: markitdown.ai
---

# Server-Sent Events progress stream

> GET https://api.markitdown.ai/v1/conversions/{id}/events — Server-Sent Events progress stream. Authenticate with x-api-key.

## Endpoint

**GET** `/v1/conversions/{id}/events` — Server-Sent Events progress stream

event: file | conversion | end. Snapshot on connect, then live updates.

## Parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `id` | path · string | yes |  |

## Example request

**curl**

```bash
curl https://api.markitdown.ai/v1/conversions/cnv_00000000000040008000000000000001/events \
  -H "x-api-key: $MARKITDOWN_API_KEY"
```

## Responses

- `200` text/event-stream.

## Related

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