Skip to Content
ConceptsCredits & plans

Credits & plans

ImaginePDF bills generation in credits, and gates some capabilities behind your workspace plan.

Credits

  • Generating a PDF costs 1 credit per document.
  • A batch job costs 1 credit per row — a 500-row batch needs 500 credits.
  • Previews are free — GET /api/v1/preview never consumes credits, so use it freely while iterating.

If your workspace has insufficient credits, the request fails with HTTP 402 and error code INSUFFICIENT_CREDITS:

{
  "status": "error",
  "data": null,
  "error": {
    "code": "INSUFFICIENT_CREDITS",
    "message": "Workspace does not have enough credits."
  }
}

Batch jobs check credit availability before queueing. If the whole batch cannot be covered, the job is rejected rather than partially run.

Plan-gated features

Some endpoints require a plan that includes the relevant feature. When the plan does not, the API responds with HTTP 403 and INSUFFICIENT_PERMISSIONS.

FeatureGatesWithout it
useApiKeysCreating and using API keys at allAPI-key routes return 403
batchGeneratePOST /api/v1/batch/generate and batchBatch endpoints return 403

Single-PDF generation, previews, designs, and assets are available on any plan that includes API access (useApiKeys).

AssetsOverview