Skip to main content
Skip to main content
DocuHub

Quick Start 

Get up and running with the DocuHub API in under 5 minutes.

  1. Get your API key

    Head to your Developer Settings and create a new API key. Give it a descriptive name like "My First Key" and select the FULL scope.

    Important: Copy your key immediately after creation. For security, the full key is only shown once. Store it in a secure location such as an environment variable or a secrets manager.

  2. Make your first request

    Convert a PDF to DOCX with a single API call. Replace YOUR_API_KEY with the key you just created.

    curl -X POST https://api.docuhub.live/v1/convert \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -F "file=@document.pdf" \
  -F "output_format=docx"

    If the file is small, you will receive the result immediately:

    json
    {
  "job_id": "job_abc123",
  "status": "completed",
  "download_url": "https://api.docuhub.live/v1/files/job_abc123/output.docx",
  "expires_at": "2026-03-15T12:30:00Z"
}

  3. Check your job status

    For larger files, the API returns a processing status. Poll the job endpoint until it completes, or configure a webhook to be notified automatically.

    curl https://api.docuhub.live/v1/jobs/job_abc123 \
  -H "Authorization: Bearer YOUR_API_KEY"

    Response while processing:

    json
    {
  "job_id": "job_abc123",
  "status": "processing",
  "progress": 42,
  "estimated_seconds_remaining": 8
}

  4. Download the result

    Once the job status is completed, use the download_url from the response to retrieve your converted file.

    curl -O -J https://api.docuhub.live/v1/files/job_abc123/output.docx \
  -H "Authorization: Bearer YOUR_API_KEY"

    Download URLs expire after 1 hour. If you need the file again, re-submit the conversion request.