Output encoding

The output_encoding parameter allows you to specify how the PDF should be encoded in the API response.

Overview

When rendering a PDF synchronously, you can choose how the generated PDF is encoded in the response. The output_encoding parameter lets you specify whether to return raw binary data or a base64-encoded string.

Parameter details

enum<string>

default:"binary"

Specifies how the PDF should be encoded in the API responseAvailable options: binary, base64

Usage

{
  "parts": "https://example.com",
  "output_encoding": "binary" // or "base64"
}

Behavior

binary: Returns the PDF as raw binary data in the response body. This is the default behavior.
base64: Returns the PDF as a base64-encoded string in the response body.

Use cases

This parameter is particularly useful for:

Direct downloads: Use binary when you want to directly download or stream the PDF to the client.
API integration: Use base64 when integrating with systems that expect base64-encoded data or when you need to include the PDF in a JSON response.
Browser compatibility: Use base64 when working with JavaScript in browsers where handling binary data might be challenging.

Example

Binary response handling (Node.js)

fetch("https://vortexpdf.com/api/v1/renderers/pdf", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer YOUR_API_KEY",
  },
  body: JSON.stringify({
    parts: "https://example.com",
    output_encoding: "binary",
  }),
})
  .then((response) => response.arrayBuffer())
  .then((buffer) => {
    // Handle binary PDF data
    fs.writeFileSync("output.pdf", Buffer.from(buffer));
  });

Base64 response handling (JavaScript)

Never include your API key directly in client-side code as it can be exposed to users. Always use a backend service to make API calls that require authentication.

fetch("https://vortexpdf.com/api/v1/renderers/pdf", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    Authorization: "Bearer YOUR_API_KEY",
  },
  body: JSON.stringify({
    parts: "https://example.com",
    output_encoding: "base64",
  }),
})
  .then((response) => response.text())
  .then((base64String) => {
    // Create a data URL for embedding in HTML or downloading
    const dataUrl = `data:application/pdf;base64,${base64String}`;

    // Create a download link
    const link = document.createElement("a");
    link.href = dataUrl;
    link.download = "document.pdf";
    link.click();
  });

Get started

Page configuration

Content handling

Output options

Asynchronous processing

Overview

Parameter details

Usage

Behavior

Use cases

Example

Binary response handling (Node.js)

Base64 response handling (JavaScript)

​Overview

​Parameter details

​Usage

​Behavior

​Use cases

​Example

​Binary response handling (Node.js)

​Base64 response handling (JavaScript)

Overview

Parameter details

Usage

Behavior

Use cases

Example

Binary response handling (Node.js)

Base64 response handling (JavaScript)