API Documentation

POST/api/convert/

Upload a document for conversion to Markdown. The API processes the file synchronously and returns the converted Markdown directly in the response.

Supported Formats

Tier Limits

Example

curl -X POST https://api.iguana-docs.com/api/convert/ \\
  -F "file=@document.pdf"

Response

{
  "job_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "completed",
  "result": "# Document Title\n\nConverted content..."
}

GET/api/convert/job/{job_id}

Check conversion status for a specific job. This is a fallback endpoint — the POST /api/convert/ endpoint now returns results synchronously. When status is "completed", the result.markdown field contains the converted content.

Status Values

Example

# Fallback: check job status (rarely needed)
curl https://api.iguana-docs.com/api/convert/job/{job_id}

Response (completed)

{
  "job_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "completed",
  "result": {
    "markdown": "# Document Title\n\nConverted content...",
    "filename": "document.pdf",
    "file_format": "pdf",
    "file_size": 1048576
  }
}

GET/api/convert/stats

Check your current usage and rate limit status. For anonymous users, limits are tracked by IP.

Example

curl https://api.iguana-docs.com/api/convert/stats

Response

{
  "tier": "free",
  "rate_limit": {
    "total_allowed": 3,
    "used": 1,
    "remaining": 2,
    "time_window": "24 hours"
  },
  "limits": {
    "max_file_size_mb": 5
  }
}

Error Codes

Full Workflow

# 1. Upload and convert (single request)
curl -X POST https://api.iguana-docs.com/api/convert/ \
  -F "file=@report.pdf"
# → { "job_id": "abc123", "status": "completed", "result": "# Report..." }

# 2. Check remaining quota
curl https://api.iguana-docs.com/api/convert/stats