Documentation

Authentication

Authentication is done by simply passing apiKey parameter to the request, using GET or POST method. You will get the apiKey parameter to your email after the registration.

Note that your "apiKey" is private information, so don't expose it publicly!

A simple example could be like this:

https://api.html2pdf.app/v1/generate?html=https://example.com&apiKey={your-api-key}

Parameters

Note that parameters should be URL encoded when sending a GET request.

Parameter	Type	Description	Default
html	`string`	HTML code or website URL you want to generate	required
apiKey	`string`	Your api key which you will get after registration, and can find in a dashboard	required
callBackUrl	`string`	Generates document in a background and sends result in your callback url. We will send generated pdf document (encoded with base64) to your provided callback url in this structure: `{"document": "..."}`	`null`
state	`string`	This is custom parameter provided by the user which will be sent to the `callBackUrl` when document is generated.	`null`
landscape	`boolean`	Activates landscape mode	`false`
format	`string`	Format of the document, can have one of values: `Letter, Legal, Tabloid, Ledger, A0, A1, A2, A3, A4, A5, A6`	`A4`
width	`integer`	Custom width of the pdf size (use in conjunction with height parameter)	`null`
height	`integer`	Custom height of the pdf size (use in conjunction with width parameter)	`null`
marginTop marginRight marginBottom marginLeft	`integer`	Empty spaces between the outer and the beginning of the content (integer value which is equal to pixels)	`0`
filename	`string`	Filename header will be returned	`null`
waitFor	`integer`	Parameter to wait for some time (in seconds) before generate the pdf document. It is useful if you have some javascript code running in the background after page was loaded. Available values from `0` to `10`.	`0`
media	`string`	Use value to generate pdf using print mode styles, can have one of values: `print`, `screen`	`screen`
scale	`number`	Defines the scale of the pdf document content. Scale range is from `0.1` to `2`	`1`
headerTemp footerTemp	`string`	Parameter to provide header / footer of the page. HTML code should be provided and used in conjunction with marginTop / marginBottom to be visible	`null`

Fonts

We support fonts listed bellow.

As an alternative way, you can use any font you want using Google fonts or Web fonts.

Andale Mono	Comic Sans MS	NotoSans	Verdana
Arial	Courier New	NotoSerif	Webdings
Arial Black	Georgia	Tahoma
Arial Narrow	Impact	Times New Roman
Arial Unicode	Microsoft Sans Serif	Trebuchet MS

Page breaks

A HTML code example if you want to force a page break at a certain point in an HTML document:

<html>
    <head>   
        <meta http-equiv="content-type" content="text/html; charset=UTF-8" />
        <title>Paginated HTML</title>
        <style>
             div.page 
            { 
            page-break-after: always; 
            page-break-inside: avoid; 
            }   
        </style> 
    <head>
    <body> 
        <div class="page">
            <h1>This is Page 1</h1>
        </div>
        <div class="page">
            <h1>This is Page 2</h1>
        </div>
        <div class="page">
            <h1>This is Page 3</h1>
        </div>
    </body>
</html>

Header and footer

HTML template for the header and footer could be provided using parameters headerTemplate and footerTemplate. The value should be valid HTML markup with following classes used to inject printing values into them:

Class name	Description
date	Formatted print date
title	Document title
url	Document location
pageNumber	Current page number
totalPages	Total pages in the document

It's important to use headerTemplate in conjunction with a large enough marginTop parameter, or footerTemplate with marginBottom to make them visible.

Template code example

<div style="font-size: 12px; padding: 0 12px; width: 100%; text-align: center;">
    Page: <span class="pageNumber"></span> of <span class="totalPages"></span> | 
    Date: <span class="date"></span> | 
    Title: <span class="title"></span> | 
    URL: <span class="url"></span> | 
    Total: <span class="totalPages"></span>
</div>

Adding an image

Unfortunately, there is no possibility to load an external resource in the header or footer.

So only one way to add an image to the header or footer is to add base64 encoded content to the image src attribute.

Using custom fonts

CSS from the web page will not be supported in header or footer, so all styles should be provided separately in the template's code.

You are free to use any of our engine supported fonts.

Template with custom CSS and image

<html>
<head>
<style>
body { font-size: 20px; font-family: 'Arial Narrow', serif; }
.footer { padding: 0 12px; width: 100%; text-align: center; }
</style>
</head>
<body>
<div class="footer">Page: <span class="pageNumber"></span> of <span
        class="totalPages"></span> | Date: <span class="date"></span> | Title: <span class="title"></span> <img
        src="data:image/png;base64, iVBORw0KGgoAAAA...kJggg=="
        style="width:30px;height:30px;" /> | URL: <span class="url"></span> | Total: <span class="totalPages"></span>
</div>
</body>
</html>