Documentation

Quickstart

1. 1
   Create an account on documento.md and go to the dashboard.
2. 2
   Generate an API Key from Dashboard → API Keys. Copy the full value (shown only once).
3. 3
   Make your first call using the header Authorization: Bearer dtmd_live_...

Authentication

All requests to /v1/* require an API Key. Use Bearer token (preferred) or the header X-API-Key:

# Preferido
Authorization: Bearer dtmd_live_xxxxxxxxxxxxx

# Alternativa
X-API-Key: dtmd_live_xxxxxxxxxxxxx

⚠️ Requests without an API Key receive 401 missing_api_key.

POST /v1/convert

Convert a document to Markdown. Upload the file as multipart/form-data.

curl -X POST "https://documento.md/v1/convert" \
  -H "Authorization: Bearer dtmd_live_xxxxx" \
  -F "file=@documento.pdf" \
  -F "wait=true"

import requests

with open("documento.pdf", "rb") as f:
    resp = requests.post(
        "https://documento.md/v1/convert",
        headers={"Authorization": "Bearer dtmd_live_xxxxx"},
        files={"file": f},
        data={"wait": "true"},
    )
print(resp.json()["markdown"])

const form = new FormData();
form.append("file", fs.createReadStream("documento.pdf"));
form.append("wait", "true");

const resp = await fetch("https://documento.md/v1/convert", {
  method: "POST",
  headers: { Authorization: "Bearer dtmd_live_xxxxx" },
  body: form,
});

Parameters: file (required), output=markdown, wait=true|false.

GET /v1/conversions/{id}

Check the status of an async conversion:

curl "https://documento.md/v1/conversions/{id}" \
  -H "Authorization: Bearer dtmd_live_xxxxx"

{
  "id": "conv_123",
  "status": "completed",
  "markdown": "# Resultado...",
  "download_url": "https://documento.md/v1/conversions/conv_123/download"
}

GET /v1/me

Inspect your key, plan and current usage:

{
  "user_id": "usr_123",
  "plan": "free",
  "limits": { "rate_limit_per_minute": 5, "daily_conversions": 50 },
  "usage": { "conversions_today": 12, "remaining_today": 38 }
}

Supported formats

Rate limiting

Each response includes these headers:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 42
X-RateLimit-Reset: 1710000000
# Solo cuando se excede:
Retry-After: 30

Error codes

All errors use the same JSON format:

{
  "error": {
    "code": "invalid_file_type",
    "message": "File type not allowed.",
    "details": { "allowed_extensions": ["pdf", "docx", ...] }
  }
}

Privacy and retention

• ✓ Original files are not stored after conversion.
• ✓ Results are retained for 24 hours and then expire.
• ✓ You can delete a result at any time with DELETE /v1/conversions/{id}.
• ✓ API Keys are stored hashed (sha256), never in plaintext.