▣ FILE CONVERSION · FILE MANIPULATION

Convert Images to PDF API

What it does

Image to PDF Converter turns uploaded images, remote image URLs, or base64-encoded image data into PDF output. Send a single image file, a URL, or base64 bytes, and get back either a downloadable PDF or a signed link to the generated file.

Use the file endpoints when you already have an image upload, the URL endpoints when the source lives elsewhere on the web, and the base64 endpoints when your app stores image data inline. Supported inputs include .png, .jpeg, .jpg, .gif, .svg, .tif, and .bmp for file uploads, with an optional landscape query parameter on the download variants to control page orientation.

The response is straightforward: download endpoints return a binary PDF, and link endpoints return a JSON object with a data field containing a URI. That makes the service easy to drop into document workflows, user-generated content pipelines, or admin tools that need to package images as PDFs for sharing, storage, or printing.

If you need to standardise image documents before emailing them, archiving them, or passing them into another system, Image to PDF Converter gives you a direct conversion path without extra file handling logic.

▣ ENDPOINT 01 / 06

POST

Convert image upload to PDF download (PDF-04)

https://api.eu.apyverse.com/apyhub/convert-images-to-pdf/file/download

QUICKSTART

GUIDE

Quickstart

Upload an image to convert it into a PDF download.

curl -X POST "https://api.eu.apyverse.com/apyhub/convert-images-to-pdf/file/download" \
  -H "apy-token: $APY_TOKEN" \
  -F "file=@/path/to/image.png"

What you'll get back

Returns a binary file stream (string with format: binary) containing the generated PDF.

(binary PDF data)

TRY ITLIVE · 60 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

Max 100MB total per request (all files combined). Larger? Use this API's URL-based endpoint instead, if it has one.

About this endpoint

What it does

Converts an uploaded image file into a PDF and returns the generated PDF as a binary download. The request accepts one image file, with optional output filename and landscape orientation settings.

Query Parameter(s)

Attribute	Type	Mandatory	Description
output	String	No	Output filename. Example: `output.pdf`.
landscape	Boolean	No	Whether to generate the PDF in landscape orientation. Default: `false`.

Request Body

Parameter	Type	Mandatory	Description
file	String	Yes	Image file to convert. Supported formats: `.png`, `.jpeg`, `.jpg`, `.gif`, `.svg`, `.tif`, `.bmp`.

Response

Returns a binary string containing the generated PDF file.

Parameter	Type	Mandatory	Description
binary	String	Yes	The generated PDF content as a binary download.

Query parameters

Name

Type

Description

outputOPTIONAL

string

—

landscapeOPTIONAL

boolean

—

DEFAULT false

Body

Name

Type

Description

bodyREQUIRED

object

—

Max 100MB total per request (all files combined). Larger? Use this API's URL-based endpoint instead, if it has one.

▣ ENDPOINT 02 / 06

POST

Convert image upload to PDF signed link (PDF-04)

https://api.eu.apyverse.com/apyhub/convert-images-to-pdf/file/link

QUICKSTART

GUIDE

Quickstart

Upload an image file to convert it into a PDF.

curl -X POST "https://api.eu.apyverse.com/apyhub/convert-images-to-pdf/file/link" \
  -H "apy-token: $APY_TOKEN" \
  -F "file=@/path/to/image.jpg"

What you'll get back

Returns a JSON object with a data string field containing the generated PDF URL.

{
  "data": "https://example.com/output.pdf"
}

TRY ITLIVE · 60 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

Max 100MB total per request (all files combined). Larger? Use this API's URL-based endpoint instead, if it has one.

About this endpoint

What it does

Converts an uploaded image file into a PDF and returns a signed link to the generated PDF. The request sends the image as multipart/form-data in the body, with an optional landscape query parameter to control page orientation.

Query Parameter(s)

Attribute	Type	Mandatory	Description
landscape	Boolean	No	Page orientation for the generated PDF. Default: `false`.

Request Body

Parameter	Type	Mandatory	Description
file	String	Yes	The image file to convert. Format: binary.

Response

Returns a JSON object with a data string field containing a URI to the generated PDF.

Parameter	Type	Mandatory	Description
data	String	Yes	Signed link to the generated PDF. Format: URI.

Query parameters

Name

Type

Description

landscapeOPTIONAL

boolean

—

DEFAULT false

Body

Name

Type

Description

bodyREQUIRED

object

—

Max 100MB total per request (all files combined). Larger? Use this API's URL-based endpoint instead, if it has one.

▣ ENDPOINT 03 / 06

POST

Convert remote image URL to PDF download (PDF-04)

https://api.eu.apyverse.com/apyhub/convert-images-to-pdf/url/download

QUICKSTART

GUIDE

Quickstart

Convert an image from a URL into a PDF. The image URL goes in the JSON body, and the optional landscape setting is sent as a query parameter.

curl -X POST "https://api.eu.apyverse.com/apyhub/convert-images-to-pdf/url/download?landscape=false" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://assets.apyhub.com/samples/sample.png"}'

What you'll get back

Returns a binary file response containing the generated PDF.

TRY ITLIVE · 60 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Converts a remote image at the provided URL into a PDF and returns the generated PDF as a binary download. You can optionally request landscape orientation with a query parameter.

Query Parameter(s)

Attribute	Type	Mandatory	Description
landscape	Boolean	No	Sets the PDF orientation to landscape. Default: `false`.

Request Body

Parameter	Type	Mandatory	Description
url	String	Yes	The remote image URL to convert. Must be a valid URI.

Response

Returns a binary response containing the generated PDF file.

Parameter	Type	Mandatory	Description
binary	String	Yes	The PDF file content returned as a binary payload.

Query parameters

Name

Type

Description

landscapeOPTIONAL

boolean

—

DEFAULT false

Body

Name

Type

Description

bodyREQUIRED

object

—

▣ ENDPOINT 04 / 06

POST

Convert remote image URL to PDF signed link (PDF-04)

https://api.eu.apyverse.com/apyhub/convert-images-to-pdf/url/link

QUICKSTART

GUIDE

Quickstart

Convert an image from a URL into a PDF by sending the image link in the request body.

curl -X POST "https://api.eu.apyverse.com/apyhub/convert-images-to-pdf/url/link" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://assets.apyhub.com/samples/sample.png"}'

What you'll get back

Returns a JSON object with a data string field containing the generated PDF URI.

{
  "data": "https://assets.apyhub.com/results/sample.pdf"
}

TRY ITLIVE · 60 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Converts a remote image URL into a PDF and returns a signed link to the generated PDF. Send the image URL in the request body; the response contains the PDF link in a data field.

Request Body

Parameter	Type	Mandatory	Description
url	String	Yes	The remote image URL to convert. Must be a URI.

Response

Returns a JSON object with a data string field containing a URI to the generated PDF file.

Parameter	Type	Mandatory	Description
data	String	Yes	Signed link to the generated PDF. Must be a URI.

Body

Name

Type

Description

bodyREQUIRED

object

—

▣ ENDPOINT 05 / 06

POST

Convert base64-encoded image to PDF download (PDF-04)

https://api.eu.apyverse.com/apyhub/convert-images-to-pdf/base64/download

QUICKSTART

GUIDE

Quickstart

Convert a Base64-encoded image file into a PDF.

curl -X POST "https://api.eu.apyverse.com/apyhub/convert-images-to-pdf/base64/download" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "base64": "iVBORw0KGgoAAAANSUhEUgAA..."
  }'

What you'll get back

Returns a binary file response , which is the generated PDF content.

(binary PDF file)

TRY ITLIVE · 60 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Converts a base64-encoded image sent in the request body into a PDF and returns the PDF as a binary download. You can optionally request landscape orientation with a query parameter.

Query Parameter(s)

Attribute	Type	Mandatory	Description
landscape	Boolean	No	Set to `true` to generate the PDF in landscape orientation. Default: `false`.

Request Body

Parameter	Type	Mandatory	Description
base64	String	Yes	Base64-encoded file bytes.

Response

Returns a binary PDF download. The success response body is a binary string, not a JSON object.

Query parameters

Name

Type

Description

landscapeOPTIONAL

boolean

—

DEFAULT false

Body

Name

Type

Description

bodyREQUIRED

object

—

▣ ENDPOINT 06 / 06

POST

Convert base64-encoded image to PDF signed link (PDF-04)

https://api.eu.apyverse.com/apyhub/convert-images-to-pdf/base64/link

QUICKSTART

GUIDE

Quickstart

Convert a base64-encoded image file into a PDF link.

curl -X POST "https://api.eu.apyverse.com/apyhub/convert-images-to-pdf/base64/link" \
  -H "apy-token: $APY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"base64":"iVBORw0KGgoAAAANSUhEUgAA..."}'

What you'll get back

Returns a JSON object with a data string field formatted as a URI — the link to the generated PDF.

{
  "data": "https://example.com/output.pdf"
}

TRY ITLIVE · 60 ATOMS

API key

Loading your default key…

The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.

About this endpoint

What it does

Converts a base64-encoded image into a PDF and returns a signed link to the generated PDF. The request takes a base64 string in the body and the response returns a JSON object containing a data URI.

Request Body

Parameter	Type	Mandatory	Description
base64	String	Yes	Base64-encoded file bytes.

Response

Returns a JSON object with a data string field formatted as a URI. The data field contains the signed link to the generated PDF.

Parameter	Type	Mandatory	Description
data	String	Yes	URI of the signed PDF link.

Body

Name

Type

Description

bodyREQUIRED

object

—

▣ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.