Pro API

Lightweight document protection — includes watermarks and metadata establishing clear chain of custody.

How It Works

The API uses asynchronous processing to handle large volumes without timeouts:

Endpoints

Submit Job

Check Status

Authentication

Authorization: Bearer aqua-api-watermark-77204041104282

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

Parameters

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-broker-funder.onrender.com/watermark-broker-funder \
  -H "Authorization: Bearer aqua-api-watermark-77204041104282" \
  -H "Content-Type: application/json" \
  -d '{
    "user_email": "[email protected]",
    "funder": ["Forward Financing", "OnDeck Capital", "Kapitus"],
    "files": [
      {
        "name": "bank-statement-jan.pdf",
        "url": "https://your-portal.com/submissions/jan.pdf"
      },
      {
        "name": "bank-statement-feb.pdf",
        "data": "JVBERi0xLjcKJeLjz9MK..."
      },
      {
        "name": "credit-application.pdf",
        "data": "JVBERi0xLjcKJeLjz9MK..."
      }
    ]
  }'

Note: You can mix files with url and files with data (base64) in the same request. The data field should contain the complete base64-encoded PDF. Convert your PDF files to base64 using any standard library before sending.

2 Response (instant)

{
  "job_id": "abc-123-def-456",
  "status": "processing",
  "file_count": 3,
  "message": "Job created successfully. Poll /job-status/{job_id} for updates."
}

3 Poll Status

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

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

While processing:

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

When complete:

{
  "job_id": "abc-123-def-456",
  "status": "complete",
  "download_url": "https://...broker-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": "error",
  "error_message": "Job timed out after 10 minutes",
  "created_at": "2025-01-06T10:00:00Z",
  "completed_at": "2025-01-06T10:10:00Z"
}

4 Download

Use the download_url from Step 3 to download the ZIP:

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

Example ZIP Contents

watermarked.zip/
├── bank-statement-jan-forward-financing.pdf
├── bank-statement-jan-ondeck-capital.pdf
├── bank-statement-jan-kapitus.pdf
├── bank-statement-feb-forward-financing.pdf
├── bank-statement-feb-ondeck-capital.pdf
├── bank-statement-feb-kapitus.pdf
├── credit-application-forward-financing.pdf
├── credit-application-ondeck-capital.pdf
└── credit-application-kapitus.pdf

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

Polling Interval

• Poll every 10 seconds until status is complete or error
• 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

Important Notes

Storage tip: Each funder receives a unique PDF, so files can accumulate quickly. We recommend deleting watermarked files immediately after confirming successful delivery to the funder by adding a basic file deletion command to your existing workflow.

Additional Examples

Single File, Multiple Funders (URL)

curl -X POST https://aquamark-broker-funder.onrender.com/watermark-broker-funder \
  -H "Authorization: Bearer aqua-api-watermark-77204041104282" \
  -H "Content-Type: application/json" \
  -d '{
    "user_email": "[email protected]",
    "funder": ["Forward Financing", "OnDeck Capital"],
    "files": [
      {
        "name": "statement.pdf",
        "url": "https://example.com/statement.pdf"
      }
    ]
  }'

Single File, Multiple Funders (Base64)

curl -X POST https://aquamark-broker-funder.onrender.com/watermark-broker-funder \
  -H "Authorization: Bearer aqua-api-watermark-77204041104282" \
  -H "Content-Type: application/json" \
  -d '{
    "user_email": "[email protected]",
    "funder": ["Forward Financing", "OnDeck Capital"],
    "files": [
      {
        "name": "statement.pdf",
        "data": "JVBERi0xLjcKJeLjz9MK..."
      }
    ]
  }'

Error Codes

Limits

• Max file size: 25MB per file
• Max funders: 15 per request
• Max funder name length: 20 characters (automatically truncated)
• Funder 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

Ready for Production?

The examples above use test credentials with Aquamark branding. To deploy with your own branding:

1. Sign up: Create an account at aquamark.io/signup
2. Upload your logo: Go to the Watermark Console in your portal
3. Billing: Subscribe from your Dashboard
4. Update your code: Replace [email protected] with your Aquamark account email in the user_email parameter

Questions? Email [email protected]