API REFERENCE / V1

Small surface area. Clear contracts.

Submit a DOCX, track its conversion, and download the resulting PDF through a focused asynchronous API.

AUTHENTICATION

Keep your API key server-side.

Create an API key from your dashboard, store it in your server-side secret manager, then send it as X-API-Key on every /v1/ request.

curl https://api.docx-pdf.com/v1/jobs/{id} \
  -H "X-API-Key: $DOCX_PDF_API_KEY"
BASE URLhttps://api.docx-pdf.com
POST
/v1/convert

Queue a DOCX file for conversion.

Request
multipart/form-data: file
Response
202 Accepted
GET
/v1/jobs/{id}

Read the current state of a conversion job.

Request
None
Response
200 OK
GET
/v1/jobs/{id}/pdf

Download the rendered PDF after the job completes.

Request
None
Response
200 OK ยท application/pdf

JOB STATES

pending

Accepted and waiting in the queue.

processing

The worker is rendering the document.

done

A PDF output is available.

failed

Rendering stopped with an error message.