List Conversions
Retrieve a paginated list of conversions via GET /conversions.
Retrieve a paginated list of conversions for your workspace. Results are ordered by creation date, newest first. Use query parameters to filter by status and control pagination.
GET https://markdownanything.com/api/v1/conversionsQuery Parameters
Prop
Type
Response Fields
Each item in the data array contains:
Prop
Type
The list endpoint does not include markdown or metadata fields. Use the Get Conversion endpoint with a specific ID to retrieve the full conversion result.
Pagination
The response includes pagination fields alongside the data array.
{
"current_page": 1,
"data": [
{
"id": "9e5fcd8a-1b2c-3d4e-5f6a-7b8c9d0e1f2a",
"status": "completed",
"original_filename": "document.pdf",
"extension": "pdf",
"file_size_bytes": 245000,
"use_enhanced_ai": false,
"created_at": "2025-01-15T10:30:00+00:00",
"started_at": "2025-01-15T10:30:01+00:00",
"completed_at": "2025-01-15T10:30:05+00:00"
},
{
"id": "a1b2c3d4-5e6f-7a8b-9c0d-e1f2a3b4c5d6",
"status": "pending",
"original_filename": "invoice.png",
"extension": "png",
"file_size_bytes": 1024000,
"use_enhanced_ai": true,
"created_at": "2025-01-15T10:29:00+00:00",
"started_at": null,
"completed_at": null
}
],
"first_page_url": "https://markdownanything.com/api/v1/conversions?page=1",
"from": 1,
"last_page": 3,
"last_page_url": "https://markdownanything.com/api/v1/conversions?page=3",
"links": [
{ "url": null, "label": "« Previous", "active": false },
{ "url": "...?page=1", "label": "1", "active": true },
{ "url": "...?page=2", "label": "2", "active": false },
{ "url": "...?page=3", "label": "3", "active": false },
{ "url": "...?page=2", "label": "Next »", "active": false }
],
"next_page_url": "https://markdownanything.com/api/v1/conversions?page=2",
"path": "https://markdownanything.com/api/v1/conversions",
"per_page": 20,
"prev_page_url": null,
"to": 20,
"total": 55
}Code Examples
List all conversions
curl https://markdownanything.com/api/v1/conversions \
-H "Authorization: Bearer mda_your_token_here"Filter by status with pagination
curl "https://markdownanything.com/api/v1/conversions?status=completed&per_page=50&page=2" \
-H "Authorization: Bearer mda_your_token_here"List all conversions
const response = await fetch("https://markdownanything.com/api/v1/conversions", {
headers: {
Authorization: "Bearer mda_your_token_here",
},
});
const result = await response.json();
console.log(`Page ${result.current_page} of ${result.last_page}`);
console.log(`${result.total} total conversions`);Filter by status
const params = new URLSearchParams({
status: "completed",
per_page: "50",
});
const response = await fetch(
`https://markdownanything.com/api/v1/conversions?${params}`,
{
headers: {
Authorization: "Bearer mda_your_token_here",
},
},
);
const { data } = await response.json();
data.forEach((conversion) => {
console.log(`${conversion.original_filename}: ${conversion.status}`);
});List all conversions
import requests
url = "https://markdownanything.com/api/v1/conversions"
headers = {"Authorization": "Bearer mda_your_token_here"}
response = requests.get(url, headers=headers)
data = response.json()
print(f"Page {data['current_page']} of {data['last_page']}")
print(f"{data['total']} total conversions")Filter by status with pagination
import requests
url = "https://markdownanything.com/api/v1/conversions"
headers = {"Authorization": "Bearer mda_your_token_here"}
params = {"status": "completed", "per_page": 50, "page": 2}
response = requests.get(url, headers=headers, params=params)
data = response.json()
for conversion in data["data"]:
print(f"{conversion['original_filename']}: {conversion['status']}")Error Responses
| Status | Error Code | Description |
|---|---|---|
401 | --- | Missing or invalid Bearer token |
422 | --- | Invalid status value or per_page out of range |