PDF Authenticity & Tamper Detection API

Authorization: Bearer YOUR_API_KEY
Content-Type: application/json

{
  "url": "https://example.com/documents/contract.pdf",
  "original_filename": "contract.pdf"
}

{
  "id": "3f9c8b7a-2e1d-4c5f-9b8e-7a6d5c4b3a21"
}

# Step 1: Submit for analysis
curl -s -X POST https://api.htpbe.tech/v1/analyze \
  -H "Authorization: Bearer htpbe_live_..." \
  -H "Content-Type: application/json" \
  -d '{"url": "https://example.com/contract.pdf"}'
# → { "id": "3f9c8b7a-2e1d-4c5f-9b8e-7a6d5c4b3a21" }

# Step 2: Retrieve full result
curl https://api.htpbe.tech/v1/result/3f9c8b7a-2e1d-4c5f-9b8e-7a6d5c4b3a21 \
  -H "Authorization: Bearer htpbe_live_..."
# → { "status": "modified", "origin": { ... }, ... }

{
  "id": "506a6b1b-1360-48a2-b389-abb346f85d04",
  "filename": "contract.pdf",
  "check_date": 1736542583,
  "file_size": 245632,
  "algorithm_version": "2.18.2",
  "current_algorithm_version": "2.18.2",
  "status": "modified",
  "origin": { "type": "institutional", "software": null },
  "creation_date": 1704110400,
  "modification_date": 1707840000,
  "creator": "Adobe Acrobat Pro DC",
  "producer": "Adobe PDF Library 15.0",
  "modification_confidence": "certain",
  "date_sequence_valid": true,
  "metadata_completeness_score": 90,
  "xref_count": 4,
  "has_incremental_updates": true,
  "update_chain_length": 3,
  "pdf_version": "1.7",
  "has_digital_signature": false,
  "signature_count": 0,
  "signature_removed": true,
  "modifications_after_signature": false,
  "page_count": 12,
  "object_count": 487,
  "has_javascript": false,
  "has_embedded_files": false,
  "modification_markers": [
    "HTPBE_SIGNATURE_REMOVED",
    "HTPBE_DATES_DISAGREE"
  ]
}

// 404 Not Found - Check doesn't exist or belongs to another client
{
  "error": "Check not found or access denied",
  "code": "not_found"
}

// 401 Unauthorized - Invalid API key
{
  "error": "Invalid API key. Please check your credentials.",
  "code": "invalid_api_key"
}

{
  "data": [
    {
      "id": "a3f5c9d2-1360-48a2-b389-abb346f85d04",
      "filename": "invoice-2024-01.pdf",
      "check_date": 1738368000,
      "status": "modified",
      "metadata_completeness_score": 85,
      "creator": "Microsoft Word for Microsoft 365",
      "producer": "Adobe PDF Library 15.0",
      "file_size": 524288,
      "page_count": 5,
      "pdf_version": "1.7",
      "creation_date": 1735689600,
      "modification_date": 1738281600,
      "has_javascript": false,
      "has_digital_signature": true,
      "has_embedded_files": false,
      "has_incremental_updates": true,
      "update_chain_length": 3,
      "object_count": 234
    }
  ],
  "total": 1250,
  "limit": 100,
  "offset": 0,
  "has_more": true
}

// Retrieve a specific check result
const checkId = '506a6b1b-1360-48a2-b389-abb346f85d04';

const response = await fetch(
  `https://api.htpbe.tech/v1/result/${checkId}`,
  {
    headers: {
      'Authorization': `Bearer ${API_KEY}`
    }
  }
);

const result = await response.json();

console.log(`File: ${result.filename}`);
console.log(`Status: ${result.status}`);
console.log(`Markers: ${result.modification_markers.join(', ')}`);

import requests
from urllib.parse import quote

# Get all modified PDFs for manual review
response = requests.get(
    'https://api.htpbe.tech/v1/checks',
    params={
        'status': 'modified',
        'limit': 100
    },
    headers={'Authorization': f'Bearer {API_KEY}'}
)

data = response.json()

print(f"Found {data['total']} modified PDFs")
print(f"\nShowing first {len(data['data'])} results:")

for check in data['data'][:5]:
    print(f"\n{check['filename']}")
    print(f"  Tool: {check['creator']} → {check['producer']}")
    print(f"  Review: https://htpbe.tech/result/{check['id']}")

// Build a dashboard from /checks — no extra endpoints needed
async function fetchDashboardData(apiKey: string) {
  const headers = { Authorization: `Bearer ${apiKey}` };

  // Fetch all checks (paginate if needed)
  const checksRes = await fetch(
    'https://api.htpbe.tech/v1/checks?limit=500',
    { headers }
  );
  const { data: checks, total } = await checksRes.json();

  // Calculate metrics from raw data
  const modified = checks.filter((c) => c.status === 'modified').length;
  const toolStats = new Map<string, { count: number; modified: number }>();

  checks.forEach((check) => {
    const tool = check.producer || 'Unknown';
    const current = toolStats.get(tool) || { count: 0, modified: 0 };
    toolStats.set(tool, {
      count: current.count + 1,
      modified: current.modified + (check.status === 'modified' ? 1 : 0)
    });
  });

  return {
    overview: {
      total,
      modified,
      modificationRate: total > 0 ? ((modified / total) * 100).toFixed(1) : '0.0'
    },
    recentModified: checks
      .filter((c) => c.status === 'modified')
      .slice(0, 5)
      .map((c) => ({ filename: c.filename, tool: c.producer })),
    toolBreakdown: Array.from(toolStats.entries())
      .map(([name, data]) => ({
        name,
        count: data.count,
        modificationRate: ((data.modified / data.count) * 100).toFixed(1)
      }))
      .sort((a, b) => b.count - a.count)
  };
}

const dashboardData = await fetchDashboardData(API_KEY);
console.log('Dashboard Data:', JSON.stringify(dashboardData, null, 2));