Funder API for Document Protection

Document protection that deters unauthorized use. Aquamark applies funder and broker attributions in the form of visible watermarks and embedded metadata, creating a strong deterrent against internal theft while signaling to brokers and merchants that their documents are safe with you.

Get Started

How It Works

The API uses asynchronous processing to handle submissions without timeouts:

Endpoints

Submit Job

Check Status

Authentication

Authorization: Bearer aqua-funder-api-101060-042858-101812

This API key is universal and can be used immediately for testing.

Parameters

Required

Max file size: 25MB per file

Note: Examples use cURL for clarity. Translate to your preferred language (Python, JavaScript, Java, etc.). Standard HTTP requests—nothing custom.

Complete Example

1 Submit Job

curl -X POST https://aquamark-funder-broker.onrender.com/watermark-funder-broker \
  -H "Authorization: Bearer aqua-funder-api-101060-042858-101812" \
  -H "Content-Type: application/json" \
  -d '{
    "user_email": "[email protected]",
    "broker_name": "ABC Capital Partners",
    "file_url": [
      "https://your-portal.com/submissions/jan-statement.pdf",
      "https://your-portal.com/submissions/feb-statement.pdf",
      "https://your-portal.com/submissions/credit-app.pdf"
    ]
  }'

Response (instant):

{
  "success": true,
  "job_id": "abc-123-def-456",
  "file_count": 3,
  "message": "Watermarking job started",
  "status_url": "/job-status/abc-123-def-456"
}

2 Poll Status

Use the job_id from Step 1 to check status every 10 seconds:

curl https://aquamark-funder-broker.onrender.com/job-status/abc-123-def-456

While processing:

{
  "job_id": "abc-123-def-456",
  "status": "processing",
  "progress": "Watermarking file 2 of 3",
  "created_at": "2025-01-06T10:00:00Z"
}

When complete:

{
  "job_id": "abc-123-def-456",
  "status": "completed",
  "download_url": "https://...funder-job-results/abc-123-def-456.zip",
  "message": "Ready for download. Files expire after 1 hour.",
  "created_at": "2025-01-06T10:00:00Z",
  "completed_at": "2025-01-06T10:01:30Z"
}

On error:

{
  "job_id": "abc-123-def-456",
  "status": "failed",
  "error_message": "Job timed out after 10 minutes",
  "created_at": "2025-01-06T10:00:00Z",
  "completed_at": "2025-01-06T10:10:00Z"
}

3 Download

Use the download_url from Step 2 to download the ZIP:

curl "https://...funder-job-results/abc-123-def-456.zip" --output watermarked.zip

Example ZIP Contents

watermarked.zip/
├── jan-statement-abc-capital-partners.pdf
├── feb-statement-abc-capital-partners.pdf
└── credit-app-abc-capital-partners.pdf

Each file is watermarked with your funder logo and the broker's name.

Polling Interval

• Poll every 10 seconds until status is completed or failed
• Jobs timeout after 10 minutes if not completed

File Availability

• Files expire after 1 hour from job completion
• Download as soon as job completes to ensure availability
• The download_url is a signed URL with built-in expiration

Error Codes

Limits

• Max file size: 25MB per file
• Max broker name length: 20 characters (automatically truncated)
• Broker names: Letters, numbers, spaces, and hyphens only
• Rate limit: 100 requests per 15 minutes per user
• Job timeout: 10 minutes
• File availability: 1 hour after completion

Important Notes

Questions? Contact [email protected]