---
title: "Office-to-PDF API"
canonical_url: "https://www.nutrient.io/guides/dws-processor/tools-and-api/office-to-pdf-api/"
md_url: "https://www.nutrient.io/guides/dws-processor/tools-and-api/office-to-pdf-api.md"
last_updated: "2026-05-26T07:02:01.697Z"
description: "Convert Word, Excel, and PowerPoint files to PDF with Nutrient DWS Processor API, including support for tracked change handling and spreadsheet print area rendering."
---

# Office-to-PDF API

Use the Office-to-PDF API to convert Office documents (DOC, DOCX, XLS, XLSX, PPT, and PPTX) to PDF. For an overview of signup, pricing, and conversion examples by file type, refer to the [Office-to-PDF API task page](https://www.nutrient.io/api/office-to-pdf-api/).

## Convert an Office file to PDF

Add an Office file (for example, `document.docx`) in the same folder as your code, and send it to the `/build` endpoint:

### Shell

### HTTP

## Convert an Office file from a URL

For remotely hosted source files, pass the URL in `parts[].file.url`:

```json

{
  "parts": [
    {
      "file": {
        "url": "https://www.nutrient.io/downloads/examples/paper.docx"
      }
    }
  ]
}

```

## Conversion parameters

Customize conversion behavior by adding parameters to each `parts` item.

> In this guide, conversion parameters are shown for the `/build` `FilePart` schema.

>
> If you need advanced Office conversion options, use the [`Build document` endpoint](https://www.nutrient.io/api/reference/public/#tag/Document-Editing/operation/build-document). The convenience endpoint `/processor/convert_to_pdf` (`Convert to PDF` in API reference) doesn’t expose all `FilePart` options.

### markup_mode

`markup_mode` controls how markup (comments and tracked changes) is preserved during Word document conversion.

- **Applicable to** — Word documents (`.docx`)

- **Supported values** —
  - `noMarkup` (default) — Render the document as if all changes were accepted
  - `original` — Render the document as if all changes were rejected
  - `simpleMarkup` — Render with changes accepted and comments as annotations
  - `allMarkup` — Render with all markups visible, including redlines and comments

- **Default** — `noMarkup`

### half_transparent_header_footer

`half_transparent_header_footer` renders headers and footers as half-transparent in the converted PDF.

- **Available via** — `/build` only

- **Not exposed by** — `/processor/convert_to_pdf`

- **Applicable to** — Word documents (`.doc`, `.docx`, `.odt`, `.rtf`)

- **Supported values** — `true`, `false`

- **Default** — `false`

### render_only_print_area

`render_only_print_area` controls spreadsheet output scope.

- **Available via** — `/build` only

- **Not exposed by** — `/processor/convert_to_pdf`

- **Applicable to** — Spreadsheet documents (`.xls`, `.xlsx`)

- **Supported values** —
  - `false` (default) — Render full sheet content
  - `true` — Render only the defined print area (falls back to full sheet if no print area is defined)

### Example with conversion parameters

```json

{
  "parts": [
    {
      "file": "document",
      "markup_mode": "allMarkup",
      "half_transparent_header_footer": true,
      "render_only_print_area": true
    }
  ]
}

```

## Related API reference operations

- [`Convert to PDF` convenience endpoint](https://www.nutrient.io/api/reference/public/#tag/Document-Editing/operation/processor-convert-to-pdf) — Higher-level endpoint with a limited parameter surface.

- [`Build document` endpoint](https://www.nutrient.io/api/reference/public/#tag/Document-Editing/operation/build-document) — Complete control, including advanced Office conversion parameters.
---

## Related pages

- [Markdown-to-PDF API](/guides/dws-processor/tools-and-api/markdown-to-pdf-api.md)
- [Tools and APIs](/guides/dws-processor/tools-and-api.md)
- [Document-to-image API](/guides/dws-processor/tools-and-api/document-to-image-api.md)
- [Image-to-PDF API](/guides/dws-processor/tools-and-api/image-to-pdf-api.md)
- [DOCX templating API](/guides/dws-processor/tools-and-api/docx-templating-api.md)
- [PDF security API](/guides/dws-processor/tools-and-api/pdf-security-api.md)
- [PDF generator API](/guides/dws-processor/tools-and-api/pdf-generator-api.md)
- [PDF-to-image API](/guides/dws-processor/tools-and-api/pdf-to-image-api.md)
- [PDF-to-PDF/A API](/guides/dws-processor/tools-and-api/pdf-to-pdfa-api.md)
- [PDF OCR API](/guides/dws-processor/tools-and-api/pdf-ocr-api.md)
- [PDF watermark API](/guides/dws-processor/tools-and-api/pdf-watermark-api.md)
- [PDF/UA auto-tagging API](/guides/dws-processor/tools-and-api/pdfua-api.md)
- [Redaction API](/guides/dws-processor/tools-and-api/redaction-api.md)