API Documentation

POST/api/convert/

Upload a document for conversion to Markdown. Files are processed asynchronously — the response returns a job_id to poll for results.

Supported Formats

Tier Limits

Example

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

Response

{
  "job_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "status": "pending",
  "message": "Document queued for conversion"
}

GET/api/convert/job/{job_id}

Poll for conversion status. When status is "completed", the result.markdown field contains the converted content.

Status Values

Example

curl https://iguana-docs.fly.dev/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://iguana-docs.fly.dev/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 document
curl -X POST https://iguana-docs.fly.dev/api/convert/ \
  -F "file=@report.pdf"
# → { "job_id": "abc123", "status": "pending" }

# 2. Poll for result (repeat until status != "pending")
curl https://iguana-docs.fly.dev/api/convert/job/abc123
# → { "status": "completed", "result": { "markdown": "..." } }

# 3. Check remaining quota
curl https://iguana-docs.fly.dev/api/convert/stats