📑 Free PDF Merger

X-API-Key: your_api_key_here

# Step 1: Start merge job
curl -X POST "https://www.bastiantechnologies.com/api/pdf/merge" \
  -H "X-API-Key: your_api_key_here" \
  -F "pdfs=@/path/to/file1.pdf" \
  -F "pdfs=@/path/to/file2.pdf" \
  -F 'order=[0,1]'

# Response: {"success":true,"jobId":"abc-123-def","status":"processing",...}

# Step 2: Check status (poll until completed)
curl -X GET "https://www.bastiantechnologies.com/api/pdf/merge/status/abc-123-def" \
  -H "X-API-Key: your_api_key_here"

# Response when complete: {"jobId":"abc-123-def","status":"completed","downloadUrl":"..."}

# Step 3: Download merged PDF
curl -X GET "https://www.bastiantechnologies.com/api/pdf/merge/download/abc-123-def" \
  -H "X-API-Key: your_api_key_here" \
  -o merged.pdf

// Step 1: Start merge job
const formData = new FormData();
formData.append('pdfs', file1);
formData.append('pdfs', file2);
formData.append('order', JSON.stringify([0, 1]));

const startResponse = await fetch('https://www.bastiantechnologies.com/api/pdf/merge', {
  method: 'POST',
  headers: { 'X-API-Key': 'your_api_key_here' },
  body: formData
});
const { jobId } = await startResponse.json();

// Step 2: Poll for completion
let status = 'processing';
while (status === 'processing') {
  await new Promise(r => setTimeout(r, 1000));
  const statusRes = await fetch(`https://www.bastiantechnologies.com/api/pdf/merge/status/${jobId}`, {
    headers: { 'X-API-Key': 'your_api_key_here' }
  });
  const data = await statusRes.json();
  status = data.status;
}

// Step 3: Download merged PDF
const downloadRes = await fetch(`https://www.bastiantechnologies.com/api/pdf/merge/download/${jobId}`, {
  headers: { 'X-API-Key': 'your_api_key_here' }
});
const blob = await downloadRes.blob();

import requests
import time

API_KEY = "your_api_key_here"
headers = {"X-API-Key": API_KEY}

# Step 1: Start merge job
files = [
    ("pdfs", open("file1.pdf", "rb")),
    ("pdfs", open("file2.pdf", "rb"))
]
data = {"order": "[0,1]"response = requests.post(
    "https://www.bastiantechnologies.com/api/pdf/merge",
    headers=headers, files=files, data=data
)
job_id = response.json()["jobId"]

# Step 2: Poll for completion
while True:
    status_res = requests.get(
        f"https://www.bastiantechnologies.com/api/pdf/merge/status/{job_id}",
        headers=headers
    )
    status = status_res.json()["status"]
    if status in ["completed", "failed"]:
        break
    time.sleep(1)

# Step 3: Download merged PDF
download_res = requests.get(
    f"https://www.bastiantechnologies.com/api/pdf/merge/download/{job_id}",
    headers=headers
)
with open("merged.pdf", "wb") as f:
    f.write(download_res.content)

// Each PDF file must use the field name "pdfs" (plural, not "pdf")
// This is critical - using "pdf" will cause a 500 error!

Body Content Type: Form-Data

Body Parameters:
┌─────────────────────────────────────────────────────────────────┐
│ Parameter Type: n8n Binary File                                │
│ Name:           pdfs  ← Must be "pdfs" (plural)               │
│ Input Data Field Name: attachment_0                            │
├─────────────────────────────────────────────────────────────────┤
│ Parameter Type: n8n Binary File                                │
│ Name:           pdfs  ← Same name "pdfs" for all files       │
│ Input Data Field Name: attachment_1                            │
└─────────────────────────────────────────────────────────────────┘

// Add more parameters with Name: "pdfs" for additional PDF files

Method: POST
URL: https://www.bastiantechnologies.com/api/pdf/merge

Authentication: Generic Credential Type → Header Auth
  Name:  X-API-Key
  Value: your_api_key_here

Body Content Type: Form-Data

Body Parameters:
  // For each PDF file from your input:
  Parameter Type: n8n Binary File
  Name:           pdfs
  Input Data Field Name: attachment_0 (or your binary field name)

  // Repeat for second PDF:
  Parameter Type: n8n Binary File
  Name:           pdfs
  Input Data Field Name: attachment_1

  // Optional: Add merge order
  Parameter Type: Form Data
  Name:           order
  Value:          [0,1]

Response Format: JSON

// Add a Loop node with condition:
Continue If: {{ $json.status !== "completed" && $json.status !== "failed" }}
Max Iterations: 60 // 2 minutes max

// Inside the loop, add Wait node (1-2 seconds), then HTTP Request:
Method: GET
URL: https://www.bastiantechnologies.com/api/pdf/merge/status/{{ $('Node 1').item.json.jobId }}

Headers:
  X-API-Key: your_api_key_here

Response Format: JSON

Method: GET
URL: {{ $('Node 2').item.json.downloadUrl }}
// Or use: https://www.bastiantechnologies.com/api/pdf/merge/download/{{ $('Node 1').item.json.jobId }}

Headers:
  X-API-Key: your_api_key_here

Response Format: File
Put Output in Field: data

{
  "success": true,
  "jobId": "f28d1c02-7cfa-4d31-a8fa-951636f3528f",
  "status": "processing",
  "message": "Merge job started",
  "statusUrl": "https://www.bastiantechnologies.com/api/pdf/merge/status/f28d1c02-...",
  "downloadUrl": "https://www.bastiantechnologies.com/api/pdf/merge/download/f28d1c02-..."
}

{
  "jobId": "f28d1c02-7cfa-4d31-a8fa-951636f3528f",
  "status": "completed",
  "progress": 100,
  "filesCount": 2,
  "totalPages": 15,
  "outputSize": 2457600,
  "processingTime": 1250,
  "downloadUrl": "https://www.bastiantechnologies.com/api/pdf/merge/download/f28d1c02-..."
}

{
  "jobId": "f28d1c02-7cfa-4d31-a8fa-951636f3528f",
  "status": "failed",
  "error": "Failed to process PDF: File is corrupted"
}