Articles on: Q&A

How Credit Usage Is Calculated

Credit usage defines how credits are used when interacting with the API. Credits are calculated based on the type of endpoint used and, where applicable, the number of pages processed or generated.

ℹ️ Credit usage is calculated on a monthly basis, from the 1st day of the month until the last day of the month. Please note that your billing period may differ from the monthly usage calculation period. The credit-based usage model applies to all new and existing customers as of January 1, 2026, replacing the previous merge-based usage calculation.

Credit calculation rules

1. Page-based credit usage

Credits are calculated based on the number of pages processed. This applies to API endpoints that generate or process PDF documents.

Page-to-credit conversion logic

For all page-based endpoints, credits are calculated using the following logic:

1–5 pages = 1 credit
6–10 pages = 2 credits
11–15 pages = 3 credits
And so on…

Each additional block of up to five pages consumes one additional credit.

a) Endpoints that generate a PDF

For API endpoints that generate a PDF as output, credits are calculated based on the number of pages in the generated PDF.

This includes the following endpoints:

Documents – Generate document (sync, async, batch, batch+async)
Conversions – HTML to PDF, URL to PDF
Services – Add Watermark, Optimize document, Fill Form Fields

If you want to test the document generation without consuming a credit, please see this article.

b) Endpoints that process a PDF

For API endpoints that accept a PDF as input and return a different output, credits are calculated based on the number of pages in the input PDF.

This includes the following endpoints:

Services – Encrypt/Decrypt document, Extract Form Fields

2. Fixed credit usage (per API call)

Some API endpoints use a fixed credit cost per API call, regardless of document size or complexity.

This applies to the following endpoints:

Generate QR Code – 1 API call = 1 credit
eInvoices – 1 API call = 1 credit

On-demand usage

To support varying usage needs, you can configure a monthly on-demand limit for your account in Billing & Invoices, allowing your usage to temporarily exceed the credits included in your plan during periods of increased demand. Usage above the included credits is calculated on the 1st day of each month for the previous month and billed separately from your recurring subscription (e.g., monthly or annual).

Once the on-demand limit is reached, on-demand services are paused until the next billing cycle.

Updated on: 31/12/2025

Was this article helpful?

Thank you!