Nutrient
Team member
Nutrient

Existing customer?

TIFF to PDF Java API

Convert TIFF files to PDF documents with our Java TIFF to PDF API.

Built for seamless integration

Use a simple API to sign and validate documents in your own platform or automate it with tools like Zapier, without dealing with complex signature logic or infrastructure.

Try it instantly on Zapier

No code? No problem. Connect Nutrient DWS Processor API to your favorite apps with Zapier to automate document workflows and save time on repetitive tasks.

Simple and transparent pricing

Select a package that suits your needs according to the number of credits you wish to spend. Each API tool and action has a specific credit cost.

Nutrient is used by

Try it out

This example will convert your uploaded TIFF file to a PDF.

1

Use Your Free API Calls

Sign up and receive 100 credits for free, or log in to automatically add your API key to sample code. If you are not sure how credits are consumed read more in our pricing documentation , or check out this guide on calculating credit usage.

Add a File

Add a TIFF file named input.tiff to your project folder. You can also use our sample file. The file name is case sensitive. Make sure the file name matches the file name in the sample code.

Run the Code

Copy the code and run it from the same folder you added the files to. For more information, see our language-specific getting started guides.

View the Results

Open result.pdf in your project folder to view the results. 

curl -X POST https://api.nutrient.io/build \
  -H "Authorization: Bearer your_api_key_here" \
  -o result.pdf \
  --fail \
  -F [email protected] \
  -F instructions='{
      "parts": [
        {
          "file": "file"
        }
      ]
    }'

curl -X POST https://api.nutrient.io/build ^
  -H "Authorization: Bearer your_api_key_here" ^
  -o result.pdf ^
  --fail ^
  -F [email protected] ^
  -F instructions="{\"parts\": [{\"file\": \"file\"}]}"

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 RequestBody body = new MultipartBody.Builder()
      .setType(MultipartBody.FORM)
      .addFormDataPart(
        "file",
        "input.tiff",
        RequestBody.create(
          MediaType.parse("image/tiff"),
          new File("input.tiff")
        )
      )
      .addFormDataPart(
        "instructions",
        new JSONObject()
          .put("parts", new JSONArray()
            .put(new JSONObject()
              .put("file", "file")
            )
          ).toString()
      )
      .build();

    final Request request = new Request.Builder()
      .url("https://api.nutrient.io/build")
      .method("POST", body)
      .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("result.pdf"),
        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/build");

      var request = new RestRequest(Method.POST)
        .AddHeader("Authorization", "Bearer your_api_key_here")
        .AddFile("file", "input.tiff")
        .AddParameter("instructions", new JsonObject
        {
          ["parts"] = new JsonArray
          {
            new JsonObject
            {
              ["file"] = "file"
            }
          }
        }.ToString());

      request.AdvancedResponseWriter = (responseStream, response) =>
      {
        if (response.StatusCode == HttpStatusCode.OK)
        {
          using (responseStream)
          {
            using var outputFileWriter = File.OpenWrite("result.pdf");
            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 formData = new FormData()
formData.append('instructions', JSON.stringify({
  parts: [
    {
      file: "file"
    }
  ]
}))
formData.append('file', fs.createReadStream('input.tiff'))

;(async () => {
  try {
    const response = await axios.post('https://api.nutrient.io/build', formData, {
      headers: formData.getHeaders({
        'Authorization': 'Bearer your_api_key_here'
      }),
      responseType: "stream"
    })

    response.data.pipe(fs.createWriteStream("result.pdf"))
  } 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 requests
import json

response = requests.request(
  'POST',
  'https://api.nutrient.io/build',
  headers = {
    'Authorization': 'Bearer your_api_key_here'
  },
  files = {
    'file': open('input.tiff', 'rb')
  },
  data = {
    'instructions': json.dumps({
      'parts': [
        {
          'file': 'file'
        }
      ]
    })
  },
  stream = True
)

if response.ok:
  with open('result.pdf', 'wb') as fd:
    for chunk in response.iter_content(chunk_size=8096):
      fd.write(chunk)
else:
  print(response.text)
  exit()

<?php

$FileHandle = fopen('result.pdf', 'w+');

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api.nutrient.io/build',
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_POSTFIELDS => array(
    'instructions' => '{
      "parts": [
        {
          "file": "file"
        }
      ]
    }',
    'file' => new CURLFILE('input.tiff')
  ),
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer your_api_key_here'
  ),
  CURLOPT_FILE => $FileHandle,
));

$response = curl_exec($curl);

curl_close($curl);

fclose($FileHandle);


POST https://api.nutrient.io/build HTTP/1.1
Content-Type: multipart/form-data; boundary=--customboundary
Authorization: Bearer your_api_key_here

--customboundary
Content-Disposition: form-data; name="instructions"
Content-Type: application/json

{
  "parts": [
    {
      "file": "file"
    }
  ]
}
--customboundary
Content-Disposition: form-data; name="file"; filename="input.tiff"
Content-Type: image/tiff

(file data)
--customboundary--
Using Postman? Download our official collection and start using the API with a single click. Read more 

Your API Key

Getting Started

The following section will walk you through how to best make use of all the functionality our Image to PDF API provides.

Converting a Single Image to PDF

Let’s start with the basics. The Image to PDF API allows you to convert any supported image file to a PDF.

The easiest way to use this is to convert a single image to a PDF. Place a page1.tiff file in the same folder as your code. You can use any image or use our provided sample page.

Run the code, and you’ll get a result.pdf with your image converted to a PDF.

Code to convert an image to PDF:

curl -X POST https://api.nutrient.io/build \
  -H "Authorization: Bearer your_api_key_here" \
  -o result.pdf \
  --fail \
  -F page1.tiff=@/path/to/page1.tiff \
  -F instructions='{
      "parts": [
        {
          "file": "page1.tiff"
        }
      ]
    }'

curl -X POST https://api.nutrient.io/build ^
  -H "Authorization: Bearer your_api_key_here" ^
  -o result.pdf ^
  --fail ^
  -F page1.tiff=@/path/to/page1.tiff ^
  -F instructions="{\"parts\": [{\"file\": \"page1.tiff\"}]}"

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 RequestBody body = new MultipartBody.Builder()
      .setType(MultipartBody.FORM)
      .addFormDataPart(
        "page1.tiff",
        "/path/to/page1.tiff",
        RequestBody.create(
          MediaType.parse("image/tiff"),
          new File("/path/to/page1.tiff")
        )
      )
      .addFormDataPart(
        "instructions",
        new JSONObject()
          .put("parts", new JSONArray()
            .put(new JSONObject()
              .put("file", "page1.tiff")
            )
          ).toString()
      )
      .build();

    final Request request = new Request.Builder()
      .url("https://api.nutrient.io/build")
      .method("POST", body)
      .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("result.pdf"),
        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/build");

      var request = new RestRequest(Method.POST)
        .AddHeader("Authorization", "Bearer your_api_key_here")
        .AddFile("page1.tiff", "/path/to/page1.tiff")
        .AddParameter("instructions", new JsonObject
        {
          ["parts"] = new JsonArray
          {
            new JsonObject
            {
              ["file"] = "page1.tiff"
            }
          }
        }.ToString());

      request.AdvancedResponseWriter = (responseStream, response) =>
      {
        if (response.StatusCode == HttpStatusCode.OK)
        {
          using (responseStream)
          {
            using var outputFileWriter = File.OpenWrite("result.pdf");
            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 formData = new FormData()
formData.append('instructions', JSON.stringify({
  parts: [
    {
      file: "page1.tiff"
    }
  ]
}))
formData.append('page1.tiff', fs.createReadStream('/path/to/page1.tiff'))

;(async () => {
  try {
    const response = await axios.post('https://api.nutrient.io/build', formData, {
      headers: formData.getHeaders({
        'Authorization': 'Bearer your_api_key_here'
      }),
      responseType: "stream"
    })

    response.data.pipe(fs.createWriteStream("result.pdf"))
  } 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 requests
import json

response = requests.request(
  'POST',
  'https://api.nutrient.io/build',
  headers = {
    'Authorization': 'Bearer your_api_key_here'
  },
  files = {
    'page1.tiff': open('/path/to/page1.tiff', 'rb')
  },
  data = {
    'instructions': json.dumps({
      'parts': [
        {
          'file': 'page1.tiff'
        }
      ]
    })
  },
  stream = True
)

if response.ok:
  with open('result.pdf', 'wb') as fd:
    for chunk in response.iter_content(chunk_size=8096):
      fd.write(chunk)
else:
  print(response.text)
  exit()

<?php

$FileHandle = fopen('result.pdf', 'w+');

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api.nutrient.io/build',
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_POSTFIELDS => array(
    'instructions' => '{
      "parts": [
        {
          "file": "page1.tiff"
        }
      ]
    }',
    'page1.tiff' => new CURLFILE('/path/to/page1.tiff')
  ),
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer your_api_key_here'
  ),
  CURLOPT_FILE => $FileHandle,
));

$response = curl_exec($curl);

curl_close($curl);

fclose($FileHandle);


POST https://api.nutrient.io/build HTTP/1.1
Content-Type: multipart/form-data; boundary=--customboundary
Authorization: Bearer your_api_key_here

--customboundary
Content-Disposition: form-data; name="instructions"
Content-Type: application/json

{
  "parts": [
    {
      "file": "page1.tiff"
    }
  ]
}
--customboundary
Content-Disposition: form-data; name="page1.tiff"; filename="/path/to/page1.tiff"
Content-Type: image/tiff

(page1.tiff data)
--customboundary--

Combining Multiple Images into a PDF

While converting a single image to a PDF is quite useful, often you’ll have a folder of images — for example, of a scanned document — that you want to combine into a single PDF.

Pass in multiple images — one for each page in your request — and Nutrient DWS API will merge all of them into a single PDF.

Add more files in the same folder as your code and run the updated code. You can duplicate and rename your existing file, or you can add some other images.

Code to convert multiple images to PDF:

curl -X POST https://api.nutrient.io/build \
  -H "Authorization: Bearer your_api_key_here" \
  -o result.pdf \
  --fail \
  -F page1.tiff=@/path/to/page1.tiff \
  -F page2.tiff=@/path/to/page2.tiff \
  -F page3.tiff=@/path/to/page3.tiff \
  -F page4.tiff=@/path/to/page4.tiff \
  -F instructions='{
      "parts": [
        {
          "file": "page1.tiff"
        },
        {
          "file": "page2.tiff"
        },
        {
          "file": "page3.tiff"
        },
        {
          "file": "page4.tiff"
        }
      ]
    }'

curl -X POST https://api.nutrient.io/build ^
  -H "Authorization: Bearer your_api_key_here" ^
  -o result.pdf ^
  --fail ^
  -F page1.tiff=@/path/to/page1.tiff ^
  -F page2.tiff=@/path/to/page2.tiff ^
  -F page3.tiff=@/path/to/page3.tiff ^
  -F page4.tiff=@/path/to/page4.tiff ^
  -F instructions="{\"parts\": [{\"file\": \"page1.tiff\"}, {\"file\": \"page2.tiff\"}, {\"file\": \"page3.tiff\"}, {\"file\": \"page4.tiff\"}]}"

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 RequestBody body = new MultipartBody.Builder()
      .setType(MultipartBody.FORM)
      .addFormDataPart(
        "page1.tiff",
        "/path/to/page1.tiff",
        RequestBody.create(
          MediaType.parse("image/tiff"),
          new File("/path/to/page1.tiff")
        )
      )
      .addFormDataPart(
        "page2.tiff",
        "/path/to/page2.tiff",
        RequestBody.create(
          MediaType.parse("image/tiff"),
          new File("/path/to/page2.tiff")
        )
      )
      .addFormDataPart(
        "page3.tiff",
        "/path/to/page3.tiff",
        RequestBody.create(
          MediaType.parse("image/tiff"),
          new File("/path/to/page3.tiff")
        )
      )
      .addFormDataPart(
        "page4.tiff",
        "/path/to/page4.tiff",
        RequestBody.create(
          MediaType.parse("image/tiff"),
          new File("/path/to/page4.tiff")
        )
      )
      .addFormDataPart(
        "instructions",
        new JSONObject()
          .put("parts", new JSONArray()
            .put(new JSONObject()
              .put("file", "page1.tiff")
            )
            .put(new JSONObject()
              .put("file", "page2.tiff")
            )
            .put(new JSONObject()
              .put("file", "page3.tiff")
            )
            .put(new JSONObject()
              .put("file", "page4.tiff")
            )
          ).toString()
      )
      .build();

    final Request request = new Request.Builder()
      .url("https://api.nutrient.io/build")
      .method("POST", body)
      .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("result.pdf"),
        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/build");

      var request = new RestRequest(Method.POST)
        .AddHeader("Authorization", "Bearer your_api_key_here")
        .AddFile("page1.tiff", "/path/to/page1.tiff")
        .AddFile("page2.tiff", "/path/to/page2.tiff")
        .AddFile("page3.tiff", "/path/to/page3.tiff")
        .AddFile("page4.tiff", "/path/to/page4.tiff")
        .AddParameter("instructions", new JsonObject
        {
          ["parts"] = new JsonArray
          {
            new JsonObject
            {
              ["file"] = "page1.tiff"
            },
            new JsonObject
            {
              ["file"] = "page2.tiff"
            },
            new JsonObject
            {
              ["file"] = "page3.tiff"
            },
            new JsonObject
            {
              ["file"] = "page4.tiff"
            }
          }
        }.ToString());

      request.AdvancedResponseWriter = (responseStream, response) =>
      {
        if (response.StatusCode == HttpStatusCode.OK)
        {
          using (responseStream)
          {
            using var outputFileWriter = File.OpenWrite("result.pdf");
            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 formData = new FormData()
formData.append('instructions', JSON.stringify({
  parts: [
    {
      file: "page1.tiff"
    },
    {
      file: "page2.tiff"
    },
    {
      file: "page3.tiff"
    },
    {
      file: "page4.tiff"
    }
  ]
}))
formData.append('page1.tiff', fs.createReadStream('/path/to/page1.tiff'))
formData.append('page2.tiff', fs.createReadStream('/path/to/page2.tiff'))
formData.append('page3.tiff', fs.createReadStream('/path/to/page3.tiff'))
formData.append('page4.tiff', fs.createReadStream('/path/to/page4.tiff'))

;(async () => {
  try {
    const response = await axios.post('https://api.nutrient.io/build', formData, {
      headers: formData.getHeaders({
        'Authorization': 'Bearer your_api_key_here'
      }),
      responseType: "stream"
    })

    response.data.pipe(fs.createWriteStream("result.pdf"))
  } 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 requests
import json

response = requests.request(
  'POST',
  'https://api.nutrient.io/build',
  headers = {
    'Authorization': 'Bearer your_api_key_here'
  },
  files = {
    'page1.tiff': open('/path/to/page1.tiff', 'rb'),
    'page2.tiff': open('/path/to/page2.tiff', 'rb'),
    'page3.tiff': open('/path/to/page3.tiff', 'rb'),
    'page4.tiff': open('/path/to/page4.tiff', 'rb')
  },
  data = {
    'instructions': json.dumps({
      'parts': [
        {
          'file': 'page1.tiff'
        },
        {
          'file': 'page2.tiff'
        },
        {
          'file': 'page3.tiff'
        },
        {
          'file': 'page4.tiff'
        }
      ]
    })
  },
  stream = True
)

if response.ok:
  with open('result.pdf', 'wb') as fd:
    for chunk in response.iter_content(chunk_size=8096):
      fd.write(chunk)
else:
  print(response.text)
  exit()

<?php

$FileHandle = fopen('result.pdf', 'w+');

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://api.nutrient.io/build',
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_POSTFIELDS => array(
    'instructions' => '{
      "parts": [
        {
          "file": "page1.tiff"
        },
        {
          "file": "page2.tiff"
        },
        {
          "file": "page3.tiff"
        },
        {
          "file": "page4.tiff"
        }
      ]
    }',
    'page1.tiff' => new CURLFILE('/path/to/page1.tiff'),
    'page2.tiff' => new CURLFILE('/path/to/page2.tiff'),
    'page3.tiff' => new CURLFILE('/path/to/page3.tiff'),
    'page4.tiff' => new CURLFILE('/path/to/page4.tiff')
  ),
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer your_api_key_here'
  ),
  CURLOPT_FILE => $FileHandle,
));

$response = curl_exec($curl);

curl_close($curl);

fclose($FileHandle);


POST https://api.nutrient.io/build HTTP/1.1
Content-Type: multipart/form-data; boundary=--customboundary
Authorization: Bearer your_api_key_here

--customboundary
Content-Disposition: form-data; name="instructions"
Content-Type: application/json

{
  "parts": [
    {
      "file": "page1.tiff"
    },
    {
      "file": "page2.tiff"
    },
    {
      "file": "page3.tiff"
    },
    {
      "file": "page4.tiff"
    }
  ]
}
--customboundary
Content-Disposition: form-data; name="page1.tiff"; filename="/path/to/page1.tiff"
Content-Type: image/tiff

(page1.tiff data)
--customboundary
Content-Disposition: form-data; name="page2.tiff"; filename="/path/to/page2.tiff"
Content-Type: image/tiff

(page2.tiff data)
--customboundary
Content-Disposition: form-data; name="page3.tiff"; filename="/path/to/page3.tiff"
Content-Type: image/tiff

(page3.tiff data)
--customboundary
Content-Disposition: form-data; name="page4.tiff"; filename="/path/to/page4.tiff"
Content-Type: image/tiff

(page4.tiff data)
--customboundary--

Security is our top priority

No document storage

No input or resulting documents are stored on our infrastructure. All files are deleted as soon as a request finishes. Alternatively, check out our self-hosted product.

HTTPS encryption

All communication between your application and Nutrient is done via HTTPS to ensure your data is encrypted when it’s sent to us.

Safe payment processing

All payments are handled by Paddle. Nutrient DWS Processor API never has direct access to any of your payment data.

Ready to try it?

Create an account to get your API key and start making API calls.