curl --request POST \
  --url 'https://api.pdf.co/v2/pdf/compress' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "url": "https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-compress/sample.pdf"
  }'

curl --request POST \
  --url 'https://api.pdf.co/v2/pdf/compress' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "url": "https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-compress/sample.pdf",
    "compression_level": "high",
    "color_quality": 60
  }'

curl --request POST \
  --url 'https://api.pdf.co/v2/pdf/compress' \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: YOUR_API_KEY' \
  --data '{
    "url": "https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-compress/sample.pdf",
    "compression_level": "high",
    "config": {
      "images": {
        "monochrome": {
          "compression": {
            "compression_format": "ccitt_g4"
          }
        }
      },
      "fonts": { "subset": false }
    }
  }'

const response = await fetch(
  "https://api.pdf.co/v2/pdf/compress",
  {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      "x-api-key": "YOUR_API_KEY",
    },
    body: JSON.stringify({
      url: "https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-compress/sample.pdf",
      compression_level: "medium",
      color_quality: 60,
      name: "compressed.pdf",
    }),
  }
);
const result = await response.json();
if (!response.ok || result.error) {
  throw new Error(result.message ?? "PDF.co request failed");
}
console.log(result.url);

import requests

response = requests.post(
    "https://api.pdf.co/v2/pdf/compress",
    headers={"x-api-key": "YOUR_API_KEY"},
    json={
        "url": "https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-compress/sample.pdf",
        "compression_level": "medium",
        "color_quality": 60,
        "name": "compressed.pdf",
    },
)
result = response.json()
if result.get("error"):
    raise RuntimeError(result.get("message", "PDF.co request failed"))
print(result["url"])

using System.Collections.Generic;
using System.Net.Http;
using System.Text;
using System.Text.Json;

var client = new HttpClient();
client.DefaultRequestHeaders.Add("x-api-key", "YOUR_API_KEY");

var payload = JsonSerializer.Serialize(new Dictionary<string, object>
{
    ["url"] = "https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-compress/sample.pdf",
    ["compression_level"] = "medium",
    ["color_quality"] = 60,
    ["name"] = "compressed.pdf",
});

var response = await client.PostAsync(
    "https://api.pdf.co/v2/pdf/compress",
    new StringContent(payload, Encoding.UTF8, "application/json")
);
var json = await response.Content.ReadAsStringAsync();
Console.WriteLine(json);

OkHttpClient client = new OkHttpClient();

String jsonPayload = "{\"url\": \"https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-compress/sample.pdf\", \"compression_level\": \"medium\", \"color_quality\": 60, \"name\": \"compressed.pdf\"}";

Request request = new Request.Builder()
    .url("https://api.pdf.co/v2/pdf/compress")
    .addHeader("x-api-key", "YOUR_API_KEY")
    .addHeader("Content-Type", "application/json")
    .post(RequestBody.create(MediaType.parse("application/json"), jsonPayload))
    .build();

try (Response response = client.newCall(request).execute()) {
    System.out.println(response.body().string());
}

<?php
$payload = json_encode([
    "url" => "https://pdfco-test-files.s3.us-west-2.amazonaws.com/pdf-compress/sample.pdf",
    "compression_level" => "medium",
    "color_quality" => 60,
    "name" => "compressed.pdf",
]);

$curl = curl_init("https://api.pdf.co/v2/pdf/compress");
curl_setopt_array($curl, [
    CURLOPT_HTTPHEADER => [
        "x-api-key: YOUR_API_KEY",
        "Content-Type: application/json",
    ],
    CURLOPT_POST => true,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_POSTFIELDS => $payload,
]);

echo curl_exec($curl);
curl_close($curl);

{
  "pageCount": 2,
  "error": false,
  "status": 200,
  "credits": 70,
  "remainingCredits": 999860,
  "duration": 8768,
  "url": "https://pdf-temp-files.s3.amazonaws.com/example/sample.pdf",
  "name": "sample.pdf",
  "outputLinkValidTill": "2026-08-08T12:00:00+00:00"
}

{
  "error": true,
  "status": 400,
  "message": "Bad request. Typically due to bad input parameters or unreachable input URLs (e.g., access restrictions like login or password)."
}

{
  "error": true,
  "status": 401,
  "message": "Unauthorized. Authentication is required and has failed or has not yet been provided."
}

{
  "error": true,
  "status": 402,
  "message": "Not enough credits."
}

{
  "error": true,
  "status": 403,
  "message": "Access forbidden for input URL."
}

{
  "error": true,
  "status": 404,
  "message": "The requested resource could not be found."
}

{
  "error": true,
  "status": 408,
  "message": "The server timed out waiting for the request."
}

{
  "error": true,
  "status": 429,
  "message": "Too many requests in a given time period."
}

{
  "error": true,
  "status": 441,
  "message": "Invalid Password. Password protected document."
}

{
  "error": true,
  "status": 442,
  "message": "Input document is damaged or of incorrect type."
}

{
  "error": true,
  "status": 443,
  "message": "Permissions. The operation is prohibited by document security settings."
}

{
  "error": true,
  "status": 444,
  "message": "Profiles parsing error. Please ensure that the configuration is supported."
}

{
  "error": true,
  "status": 445,
  "message": "Timeout error. For large documents, use asynchronous mode (async=true) and check status via /job/check."
}

{
  "error": true,
  "status": 446,
  "message": "Some files required for conversion are missing."
}

{
  "error": true,
  "status": 447,
  "message": "Invalid template."
}

{
  "error": true,
  "status": 448,
  "message": "Invalid URL or HTML. Ensure the provided URL is valid and accessible."
}

{
  "error": true,
  "status": 449,
  "message": "Invalid index range. Page index is out of range."
}

{
  "error": true,
  "status": 450,
  "message": "Invalid page range specified."
}

{
  "error": true,
  "status": 452,
  "message": "Invalid URL."
}

{
  "error": true,
  "status": 454,
  "message": "Invalid parameters."
}

{
  "error": true,
  "status": 500,
  "message": "Something went wrong. Please try again or contact support."
}