Skip to main content
DocuHub

Quick Start

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

Back to Docs
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:

{
  "job_id": "job_abc123",
  "status": "completed",
  "download_url": "https://api.docuhub.live/v1/files/job_abc123/output.docx",
  "expires_at": "2025-01-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:

{
  "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.

Next steps

Create your API key