apyhub
FILE CONVERSION · FILE MANIPULATION

Convert Spreadsheets to PDF API

What it does

Spreadsheet to PDF converts spreadsheet files into PDF output. Send an .xls, .xlsx, or .ods file, a remote spreadsheet URL, or base64-encoded spreadsheet bytes, and get back either a PDF download or a signed PDF link.

Use Spreadsheet to PDF when you need to share a workbook as a fixed-layout document, archive a spreadsheet for review, or generate a printable version for clients and internal workflows. The download endpoints return the PDF as binary content, while the link endpoints return a URI in a data field for deferred retrieval.

You can also set landscape on the download endpoints to render the PDF in landscape orientation when the spreadsheet is wide. For file uploads, the service accepts the spreadsheet in the request body as file; for remote sources, send url; for encoded content, send base64.

Choose the upload, URL, or base64 path that matches your pipeline, then consume the PDF in the format your application needs.

▣ ENDPOINT 01 / 06
POST
Convert spreadsheet upload to PDF download (PDF-03)
https://api.eu.apyverse.com/apyhub/convert-spreadsheets-to-pdf/file/download

QUICKSTART

GUIDE

Quickstart

Convert an uploaded spreadsheet file to PDF and download the result.

curl -X POST "https://api.eu.apyverse.com/apyhub/convert-spreadsheets-to-pdf/file/download?output=output.pdf" \
  -H "apy-token: $APY_TOKEN" \
  -F "file=@/path/to/spreadsheet.xlsx"

What you'll get back

Returns a binary file containing the generated PDF.

TRY ITLIVE · 60 ATOMS
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.
body*
.xls, .xlsx, or .ods

About this endpoint

What it does

Converts an uploaded spreadsheet file to a PDF and returns the generated PDF as a binary download. The request accepts a spreadsheet upload plus optional output settings via query parameters.

Query Parameter(s)

AttributeTypeMandatoryDescription
outputStringNoOutput file name. Example: output.pdf.
landscapeBooleanNoWhether to render the PDF in landscape orientation. Default: false.

Request Body

ParameterTypeMandatoryDescription
fileStringYesSpreadsheet file to convert. Must be an .xls, .xlsx, or .ods binary upload.

Response

Returns a binary file download containing the generated PDF. The response schema is a binary string.

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 spreadsheet upload to PDF signed link (PDF-03)
https://api.eu.apyverse.com/apyhub/convert-spreadsheets-to-pdf/file/link

QUICKSTART

GUIDE

Quickstart

Convert a spreadsheet file from a link to PDF with the required upload field.

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

What you'll get back

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

{
  "data": "https://example.com/output.pdf"
}
TRY ITLIVE · 60 ATOMS
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.
body*

About this endpoint

What it does

Converts an uploaded spreadsheet file to PDF and returns a signed link to the generated PDF. The request sends the file as multipart form data, and the response contains the PDF URL in a data field.

Query Parameter(s)

AttributeTypeMandatoryDescription
landscapeBooleanNoOptional page orientation flag. Default: false.

Request Body

ParameterTypeMandatoryDescription
fileStringYesSpreadsheet file to convert. Binary upload.

Response

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

ParameterTypeMandatoryDescription
dataStringYesSigned URI for the converted PDF output.

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 spreadsheet URL to PDF download (PDF-03)
https://api.eu.apyverse.com/apyhub/convert-spreadsheets-to-pdf/url/download

QUICKSTART

GUIDE

Quickstart

Convert a spreadsheet from a public URL to PDF.

curl -X POST "https://api.eu.apyverse.com/apyhub/convert-spreadsheets-to-pdf/url/download" \
  -H "apy-token: $APY_TOKEN" \
  -d '{
    "url": "https://assets.apyhub.com/samples/sample.xlsx"
  }'

What you'll get back

Returns a binary PDF file in the response body.

TRY ITLIVE · 60 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.
body*

About this endpoint

What it does

Converts a spreadsheet available at a remote URL into a PDF file and returns the generated PDF as binary output. You provide the source spreadsheet URL in the request body, and can optionally request landscape orientation via a query parameter.

Query Parameter(s)

AttributeTypeMandatoryDescription
landscapeBooleanNoSet to true to generate the PDF in landscape orientation. Defaults to false.

Request Body

ParameterTypeMandatoryDescription
urlStringYesThe remote spreadsheet URL to convert. Must be a valid URI.

Response

Returns a binary PDF file as the success response. The output schema is a binary string, so the response body contains the generated document rather than a JSON object.

ParameterTypeMandatoryDescription
responseStringYesBinary PDF content returned by the endpoint.

Query parameters

Name
Type
Description
landscapeOPTIONAL
boolean
DEFAULT false

Body

Name
Type
Description
bodyREQUIRED
object
▣ ENDPOINT 04 / 06
POST
Convert remote spreadsheet URL to PDF signed link (PDF-03)
https://api.eu.apyverse.com/apyhub/convert-spreadsheets-to-pdf/url/link

QUICKSTART

GUIDE

Quickstart

Convert a spreadsheet from a public URL into a PDF by sending the file link in the request body.

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

What you'll get back

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

{
  "data": "https://..."
}
TRY ITLIVE · 60 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.
body*

About this endpoint

What it does

Converts a spreadsheet available at a remote URL into a PDF and returns a signed PDF link. You submit the source spreadsheet URL in the request body, and the response contains the generated PDF URL.

Request Body

ParameterTypeMandatoryDescription
urlStringYesRemote spreadsheet URL to convert. Must be a URI.

Response

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

ParameterTypeMandatoryDescription
dataStringYesSigned URL of the generated PDF. Must be a URI.

Body

Name
Type
Description
bodyREQUIRED
object
▣ ENDPOINT 05 / 06
POST
Convert base64-encoded spreadsheet to PDF download (PDF-03)
https://api.eu.apyverse.com/apyhub/convert-spreadsheets-to-pdf/base64/download

QUICKSTART

GUIDE

Quickstart

Convert a spreadsheet to a PDF download from its base64-encoded contents.

curl -X POST "https://api.eu.apyverse.com/apyhub/convert-spreadsheets-to-pdf/base64/download?landscape=false" \
  -H "apy-token: $APY_TOKEN" \
  -d '{"base64":"UEsDBBQAAAAIAAAAIQAAAAAAAAAAAAAAAAAJAAAAdGVzdC54bHN4"}'

What you'll get back

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

PDF file bytes
TRY ITLIVE · 60 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.
body*
Base64-encoded file bytes.

About this endpoint

What it does

Converts a base64-encoded spreadsheet file into a PDF and returns the generated PDF as binary download content. The request accepts the encoded file bytes in the body and an optional landscape query parameter to control page orientation.

Query Parameter(s)

AttributeTypeMandatoryDescription
landscapeBooleanNoDefaults to false. When true, the PDF is generated in landscape orientation.

Request Body

ParameterTypeMandatoryDescription
base64StringYesBase64-encoded file bytes.

Response

Returns a binary response containing the generated PDF file.

Query parameters

Name
Type
Description
landscapeOPTIONAL
boolean
DEFAULT false

Body

Name
Type
Description
bodyREQUIRED
object
▣ ENDPOINT 06 / 06
POST
Convert base64-encoded spreadsheet to PDF signed link (PDF-03)
https://api.eu.apyverse.com/apyhub/convert-spreadsheets-to-pdf/base64/link

QUICKSTART

GUIDE

Quickstart

Convert a spreadsheet from a base64 string into a PDF link with a single request.

curl -X POST "https://api.eu.apyverse.com/apyhub/convert-spreadsheets-to-pdf/base64/link" \
  -H "apy-token: $APY_TOKEN" \
  -d '{
    "base64": "UEsDBBQAAAAIAAeLbUoAAAAAAAAAAAAAAAAJAAQATWVudXNlci54bWxVVAkAA9mZYGXZmWBldXgLAAEE6AMAAAToAwAA..."
  }'

What you'll get back

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

{
  "data": "https://example.com/generated-file.pdf"
}
TRY ITLIVE · 60 ATOMS
Loading your default key…
The full key is used to call the gateway and stays in this tab — never sent to orbit or saved.
body*
Base64-encoded file bytes.

About this endpoint

What it does

Converts a base64-encoded spreadsheet file into a PDF and returns a signed PDF link. The request body contains the encoded file bytes, and the success response returns a JSON object with a data string field containing the URI.

Request Body

ParameterTypeMandatoryDescription
base64StringYesBase64-encoded file bytes.

Response

Returns a JSON object with a data string field formatted as a URI. The data field contains the signed PDF link generated from the uploaded base64-encoded spreadsheet.

ParameterTypeMandatoryDescription
dataStringYesURI 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.