---
title: "Get one file"
description: "GET https://api.markitdown.ai/v1/conversions/{id}/files/{file_id} — Get one file. Authenticate with x-api-key."
url: https://markitdown.ai/docs/api/get-conversion-file
updated: 2026-09-26
source: markitdown.ai
---

# Get one file

> GET https://api.markitdown.ai/v1/conversions/{id}/files/{file_id} — Get one file. Authenticate with x-api-key.

## Endpoint

**GET** `/v1/conversions/{id}/files/{file_id}` — Get one file

`getConversionFile` is part of the Conversions resource of the markitdown.ai API v1. Send an API key in the `x-api-key` header (or `Authorization: Bearer mdai_…`); all bodies are `application/json` unless a response lists another media type.

## Parameters

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

## Example request

**curl**

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

## Responses

- `200` File. (`application/json`) — `File`
- `404` Not found (`application/problem+json`) — `Problem`

**200 body — File**

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `bytes` | integer \| null | no |  |
| `content` | string \| null | no |  |
| `credits` | integer \| null | no |  |
| `error` | object \| any \| null | no |  |
| `format` | "markdown" \| "text" \| "html" \| "pages" | no |  |
| `id` | string | yes |  |
| `links` | object | no |  |
| `mime` | string | yes |  |
| `name` | string | yes |  |
| `object` | "file" | yes |  |
| `outputs` | object[] | no |  |
| `outputs[].bytes` | integer \| null | no |  |
| `outputs[].content` | string \| null | no |  |
| `outputs[].credits` | integer \| null | no |  |
| `outputs[].error` | object \| any \| null | no |  |
| `outputs[].format` | "markdown" \| "text" \| "html" \| "pages" | no |  |
| `outputs[].id` | string | yes |  |
| `outputs[].links` | object | no |  |
| `outputs[].mime` | string | yes |  |
| `outputs[].name` | string | yes |  |
| `outputs[].object` | "file" | yes |  |
| `outputs[].outputs` | object[] | no |  |
| `outputs[].pages` | integer \| null | no |  |
| `outputs[].role` | "source" \| "output" | yes |  |
| `outputs[].status` | "queued" \| "running" \| "completed" \| "failed" | no |  |
| `outputs[].variant` | "standard" \| "ai_enhanced" | no |  |
| `pages` | integer \| null | no |  |
| `role` | "source" \| "output" | yes |  |
| `status` | "queued" \| "running" \| "completed" \| "failed" | no |  |
| `variant` | "standard" \| "ai_enhanced" | no |  |

## Errors

- [Error codes](/docs/errors) — every `error` code with its status, meaning and whether to retry

## 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)