Skip to main content

How it works

PDFBase uses prepaid credits. Buy a pack, use them whenever. No monthly commitments, no unused credits going to waste. 1 credit = 1 successful PDF operation (generation, render, merge, extract, etc.) Failed requests cost 0 credits. You only pay for successful output.

Credit packs

Credits are valid for 12 months from purchase date. Unused credits after 12 months expire.

Free tier

Every new account gets 100 free credits. No credit card required. Build, test, and ship before you pay anything. Free credits work identically to purchased credits — no watermarks, no feature restrictions, no rate limit differences.

Auto-refill

Set a threshold and a pack size. When your balance drops below the threshold, we automatically purchase the selected pack using your saved payment method.
Configure auto-refill in your dashboard billing settings.
Auto-refill prevents service interruptions. If your balance hits 0 without auto-refill, API calls return 402 Payment Required until you purchase more credits.

What costs a credit

AI structured extraction costs 2 credits because it runs an LLM inference step on top of text extraction. All other operations cost 1 credit.

What’s free (0 credits)

  • Failed requests (any error response)
  • Retrieving PDF metadata (GET /v1/pdfs/:id)
  • Listing resources (GET /v1/pdfs, GET /v1/templates)
  • Template CRUD (create, update, delete)
  • Webhook endpoint management
  • Debug mode (no extra credit cost — just pass debug: true)
  • Request replay from dashboard

Balance headers

Every API response includes your current credit balance:
When your balance is low (below 100 credits), responses include a warning header:

When credits run out

If your balance reaches 0, API calls that consume credits return 402 Payment Required:
Read-only operations (GET endpoints, listing resources) continue to work with 0 credits.

Payment processing

Payments are processed by Dodo Payments. All major credit cards, UPI, and international payment methods are supported. Invoices are available in your dashboard.

Enterprise

Need custom volume pricing, SLAs, or dedicated infrastructure? Contact us.