Estimate request cost
With Nutrient DWS Processor API, you can perform a variety of document management actions in a single request. Each request is priced per operation in US dollars and charged to your plan’s monthly usage first, then to your wallet. This guide covers how you can find out what your requests cost.
If you need to return from this pricing-detail view to broader evaluation or setup, continue to API pricing for plans and commercial review, getting started for API key setup and a first request, the REST API reference for endpoint details, or the Processor API overview for broader product context.
Pricing per tool
You can learn the price of a certain API processing tool by referring to the pricing table(opens in a new tab).
Another option is to visit any of our tool pages, which contain a badge with the price of the tool.

If you’re combining multiple processing actions, your cost will be the sum of the prices of the tools you used in your combine workflow.
Analyze build requests
If you’re using the Build API, you can calculate the estimated cost of a particular Build API request without actually executing it. The request is free of charge.
If you’re processing other content types as PDFs, don’t forget that conversions during processing can also incur additional costs. The analyze request can take this into account if you also provide a content type for all of the non-PDF content types.
For example, consider the following complex request:
curl -X POST https://api.nutrient.io/analyze_build \ -H "Content-Type: application/json" \ -H "Authorization: Bearer your_api_key_here" \ -o analyze_result.json \ --fail \ -d '{ "parts": [ { "file": "document", "content_type": "image/gif" }, { "file": "document2", "content_type": "image/png", "actions": [ { "type": "ocr", "language": "english" } ] } ], "actions": [ { "type": "flatten" }, { "type": "rotate", "rotateBy": 90 } ], "output": { "type": "pdfua", "owner_password": "test123", "user_password": "test3", "metadata": { "title": "title" }, "optimize": { "mrcCompression": true, "linearize": true } } }'curl -X POST https://api.nutrient.io/analyze_build ^ -H "Content-Type: application/json" ^ -H "Authorization: Bearer your_api_key_here" ^ -o analyze_result.json ^ --fail ^ -d "{\"parts\": [{\"file\": \"document\", \"content_type\": \"image/gif\"}, {\"file\": \"document2\", \"content_type\": \"image/png\", \"actions\": [{\"type\": \"ocr\", \"language\": \"english\"}]}], \"actions\": [{\"type\": \"flatten\"}, {\"type\": \"rotate\", \"rotateBy\": 90}], \"output\": {\"type\": \"pdfua\", \"owner_password\": \"test123\", \"user_password\": \"test3\", \"metadata\": {\"title\": \"title\"}, \"optimize\": {\"mrcCompression\": true, \"linearize\": true}}}"package com.example.pspdfkit;
import java.io.File;import java.io.IOException;import java.nio.file.FileSystems;import java.nio.file.Files;import java.nio.file.StandardCopyOption;
import org.json.JSONArray;import org.json.JSONObject;
import okhttp3.MediaType;import okhttp3.MultipartBody;import okhttp3.OkHttpClient;import okhttp3.Request;import okhttp3.RequestBody;import okhttp3.Response;
public final class PspdfkitApiExample { public static void main(final String[] args) throws IOException { final MediaType mediaType = MediaType.parse("application/json"); final RequestBody body = RequestBody.create( mediaType, new JSONObject() .put("parts", new JSONArray() .put(new JSONObject() .put("file", "document") .put("content_type", "image/gif") ) .put(new JSONObject() .put("file", "document2") .put("content_type", "image/png") .put("actions", new JSONArray() .put(new JSONObject() .put("type", "ocr") .put("language", "english") ) ) ) ) .put("actions", new JSONArray() .put(new JSONObject() .put("type", "flatten") ) .put(new JSONObject() .put("type", "rotate") .put("rotateBy", 90) ) ) .put("output", new JSONObject() .put("type", "pdfua") .put("owner_password", "test123") .put("user_password", "test3") .put("metadata", new JSONObject() .put("title", "title") ) .put("optimize", new JSONObject() .put("mrcCompression", true) .put("linearize", true) ) ).toString() );
final Request request = new Request.Builder() .url("https://api.nutrient.io/analyze_build") .method("POST", body) .addHeader("Content-Type", "application/json") .addHeader("Authorization", "Bearer your_api_key_here") .build();
final OkHttpClient client = new OkHttpClient() .newBuilder() .build();
final Response response = client.newCall(request).execute();
if (response.isSuccessful()) { Files.copy( response.body().byteStream(), FileSystems.getDefault().getPath("analyze_result.json"), StandardCopyOption.REPLACE_EXISTING ); } else { // Handle the error. throw new IOException(response.body().string()); } }}using System;using System.IO;using System.Net;using RestSharp;
namespace PspdfkitApiDemo{ class Program { static void Main(string[] args) { var client = new RestClient("https://api.nutrient.io/analyze_build");
var request = new RestRequest(Method.POST) .AddHeader("Authorization", "Bearer your_api_key_here") .AddJsonBody(new JsonObject { ["parts"] = new JsonArray { new JsonObject { ["file"] = "document", ["content_type"] = "image/gif" }, new JsonObject { ["file"] = "document2", ["content_type"] = "image/png", ["actions"] = new JsonArray { new JsonObject { ["type"] = "ocr", ["language"] = "english" } } } }, ["actions"] = new JsonArray { new JsonObject { ["type"] = "flatten" }, new JsonObject { ["type"] = "rotate", ["rotateBy"] = 90 } }, ["output"] = new JsonObject { ["type"] = "pdfua", ["owner_password"] = "test123", ["user_password"] = "test3", ["metadata"] = new JsonObject { ["title"] = "title" }, ["optimize"] = new JsonObject { ["mrcCompression"] = true, ["linearize"] = true } } });
request.AdvancedResponseWriter = (responseStream, response) => { if (response.StatusCode == HttpStatusCode.OK) { using (responseStream) { using var outputFileWriter = File.OpenWrite("analyze_result.json"); responseStream.CopyTo(outputFileWriter); } } else { var responseStreamReader = new StreamReader(responseStream); Console.Write(responseStreamReader.ReadToEnd()); } };
client.Execute(request); } }}// This code requires Node.js. Do not run this code directly in a web browser.
const axios = require("axios");const FormData = require("form-data");const fs = require("fs");
const body = JSON.stringify({ parts: [ { file: "document", content_type: "image/gif", }, { file: "document2", content_type: "image/png", actions: [ { type: "ocr", language: "english", }, ], }, ], actions: [ { type: "flatten", }, { type: "rotate", rotateBy: 90, }, ], output: { type: "pdfua", owner_password: "test123", user_password: "test3", metadata: { title: "title", }, optimize: { mrcCompression: true, linearize: true, }, },});
(async () => { try { const response = await axios.post( "https://api.nutrient.io/analyze_build", body, { headers: { "Content-Type": "application/json", Authorization: "Bearer your_api_key_here", }, responseType: "stream", }, );
response.data.pipe(fs.createWriteStream("analyze_result.json")); } catch (e) { const errorString = await streamToString(e.response.data); console.log(errorString); }})();
function streamToString(stream) { const chunks = []; return new Promise((resolve, reject) => { stream.on("data", (chunk) => chunks.push(Buffer.from(chunk))); stream.on("error", (err) => reject(err)); stream.on("end", () => resolve(Buffer.concat(chunks).toString("utf8"))); });}import requestsimport json
body = json.dumps({ 'parts': [ { 'file': 'document', 'content_type': 'image/gif' }, { 'file': 'document2', 'content_type': 'image/png', 'actions': [ { 'type': 'ocr', 'language': 'english' } ] } ], 'actions': [ { 'type': 'flatten' }, { 'type': 'rotate', 'rotateBy': 90 } ], 'output': { 'type': 'pdfua', 'owner_password': 'test123', 'user_password': 'test3', 'metadata': { 'title': 'title' }, 'optimize': { 'mrcCompression': true, 'linearize': true } }})
response = requests.request( 'POST', 'https://api.nutrient.io/analyze_build', headers = { 'Content-Type': 'application/json', 'Authorization': 'Bearer your_api_key_here' }, data = body, stream = True)
if response.ok: with open('analyze_result.json', 'wb') as fd: for chunk in response.iter_content(chunk_size=8096): fd.write(chunk)else: print(response.text) exit()<?php
$FileHandle = fopen('analyze_result.json', 'w+');
$curl = curl_init();
$body = '{ "parts": [ { "file": "document", "content_type": "image/gif" }, { "file": "document2", "content_type": "image/png", "actions": [ { "type": "ocr", "language": "english" } ] } ], "actions": [ { "type": "flatten" }, { "type": "rotate", "rotateBy": 90 } ], "output": { "type": "pdfua", "owner_password": "test123", "user_password": "test3", "metadata": { "title": "title" }, "optimize": { "mrcCompression": true, "linearize": true } }}';
curl_setopt_array($curl, array( CURLOPT_URL => 'https://api.nutrient.io/analyze_build', CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_RETURNTRANSFER => true, CURLOPT_ENCODING => '', CURLOPT_POSTFIELDS => $body, CURLOPT_HTTPHEADER => array( 'Content-Type: application/json', 'Authorization: Bearer your_api_key_here' ), CURLOPT_FILE => $FileHandle,));
$response = curl_exec($curl);
curl_close($curl);
fclose($FileHandle);POST https://api.nutrient.io/analyze_build HTTP/1.1Content-Type: application/jsonAuthorization: Bearer your_api_key_here
{ "parts": [ { "file": "document", "content_type": "image/gif" }, { "file": "document2", "content_type": "image/png", "actions": [ { "type": "ocr", "language": "english" } ] } ], "actions": [ { "type": "flatten" }, { "type": "rotate", "rotateBy": 90 } ], "output": { "type": "pdfua", "owner_password": "test123", "user_password": "test3", "metadata": { "title": "title" }, "optimize": { "mrcCompression": true, "linearize": true } }}This request responds with the following cost breakdown, in US dollars:
{ "billing": { "currency": "USD", "estimatedCost": null, "components": [ { "product": "accessibility", "operation": "pdf_to_pdfua", "unit": "page", "quantity": null, "unitPrice": "0.395", "cost": null }, { "product": "processor", "operation": "annotations", "unit": "use", "quantity": 1, "unitPrice": "0.0375", "cost": "0.0375" }, { "product": "processor", "operation": "compression", "unit": "use", "quantity": 1, "unitPrice": "0.15", "cost": "0.15" }, { "product": "processor", "operation": "document_editor", "unit": "use", "quantity": 3, "unitPrice": "0.075", "cost": "0.225" }, { "product": "processor", "operation": "image_conversion", "unit": "use", "quantity": 2, "unitPrice": "0.0375", "cost": "0.075" }, { "product": "processor", "operation": "linearization", "unit": "use", "quantity": 1, "unitPrice": "0.15", "cost": "0.15" }, { "product": "processor", "operation": "ocr", "unit": "page", "quantity": null, "unitPrice": "0.15", "cost": null } ] }}Each component is one operation the request uses, with its unitPrice and, where it can be known in advance, its quantity and cost. OCR and PDF/UA are priced per page, and the page count isn’t known until the request runs, so their quantity and cost are null, and so is the total estimatedCost. To estimate the full request, multiply each per-page unitPrice by the number of pages you expect, and add the other components’ cost. Here, for a two-page output, that’s $0.6375 for the per-use operations, plus $1.09 for OCR and PDF/UA.
For all response fields, refer to the analyze Build API guide. Accounts still on a credits plan get the earlier response, with costs in credits.
Get costs from live requests
If you don’t want to deal with separate requests or calculate your costs from the pricing table manually, Nutrient DWS Processor API also reports the actual cost in all Build and Sign API responses.
Refer to the following custom response headers, all in US dollars:
x-nutrient-request-cost-usd— The actual billed cost of the request, for example0.15.x-nutrient-included-balance-usd— What’s left of your plan’s monthly usage after the request.x-nutrient-wallet-balance-usd— Your pay-as-you-go wallet balance after the request.
The balances are informational, as they don’t include pending deductions on your account. Accounts still on a credits plan get x-pspdfkit-request-cost and x-pspdfkit-remaining-credits instead, in credits.