Broker API (Legacy)

Same-day setup.

Your workflow, your way. A simple endpoint you can integrate anywhere in your system—triggered by a button click or embedded seamlessly into your existing workflows.

SOC2 Type II Certified Infrastructure

Zero permanent storage • Documents processed on Render & Supabase • Files never saved

Setup time: 2-4 hours

Standard HTTP requests • Most developers complete integration same day

Endpoint

POST https://aquamark-decrypt.onrender.com/watermark

Authentication

Authorization: Bearer aqua-api-watermark-10182013040420111015

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

Parameters

Parameter	Type	Description
`user_email`	String	Your Aquamark account email Use `[email protected]` for testing with Aquamark branding

File Input — choose one:

Option	Parameter	Type	Description
A	`file_url`	String (JSON body)	Public URL to a file (PDF, DOC, DOCX, JPG, PNG)
B	`file`	File (multipart form-data)	Direct file upload (PDF, DOC, DOCX, JPG, PNG)

Use Option A or Option B — not both. Max 25MB per file.

Supported File Types

You send	You get back	Notes
PDF	PDF	Every page watermarked
Word (.doc, .docx)	PDF	Converted to PDF, then watermarked — recipients can't edit it
Image (.jpg, .jpeg, .png)	JPG	Watermark tiled across the full image — ideal for voided checks, IDs, and screenshots

File type is detected from the file name (from file_url or the uploaded file), so make sure it ends in the right extension.

Note: examples are shown in cURL for universality. Translate to your preferred language (Python, JavaScript, Java, etc.). Standard HTTP request — nothing custom.

Example: JSON with File URL

curl -X POST https://aquamark-decrypt.onrender.com/watermark \
  -H "Authorization: Bearer aqua-api-watermark-10182013040420111015" \
  -H "Content-Type: application/json" \
  -d '{
    "file_url": "https://example.com/document.pdf",
    "user_email": "[email protected]"
  }' \
  --output watermarked.pdf

Example: Form-Data File Upload

curl -X POST https://aquamark-decrypt.onrender.com/watermark \
  -H "Authorization: Bearer aqua-api-watermark-10182013040420111015" \
  -F "file=@/path/to/document.pdf" \
  -F "[email protected]" \
  --output watermarked.pdf

Both methods return a watermarked file

Example: Image

curl -X POST https://aquamark-decrypt.onrender.com/watermark \
  -H "Authorization: Bearer aqua-api-watermark-10182013040420111015" \
  -H "Content-Type: application/json" \
  -d '{
    "file_url": "https://www.aquamark.io/voided-check-sample.jpg",
    "user_email": "[email protected]"
  }' \
  --output voided-check-protected.jpg

Word documents work the same way — send a .docx or .doc and save the response as .pdf.

Response

Returns the watermarked file (binary stream) with your branding

PDFs and Word documents: application/pdf, named [original-name]-protected.pdf
Images: image/jpeg, named [original-name]-protected.jpg
File is streamed directly to you (not stored on our servers)

Important

One file per request. This endpoint processes one file at a time. For batch processing, make multiple API calls.

Files never stored. Your file is processed in memory and immediately returned. We never save your documents.

Error Codes

Errors return plain text messages with appropriate HTTP status codes.

Code	Meaning	Example Response
400	Bad request	`Missing user_email` `Missing file or file_url` `Unable to process PDF: [details]` `Unable to convert Word document: [details]`
401	Invalid API key	`Invalid API key.`
402	Account not authorized	`Free trial has expired` `User not authorized`
408	Request timeout	`Request timeout - processing took too long. Please try again or contact support.`
413	File too large	`File size 30.5MB exceeds maximum allowed size of 25MB.`
500	Server error	`Failed to process watermark: [error details]`

Limits

Supported file types: PDF, DOC, DOCX, JPG, JPEG, PNG
Max file size: 25MB per file
One file per request

Ready for Production?

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

Sign up: Create an account at aquamark.io/signup
Upload your logo: Go to the Watermark Console in your portal
Subscribe: Select the Standard plan
Update your code: Replace [email protected] with your Aquamark account email in the user_email parameter

That's it. Your documents will now be watermarked with your branding.

Support

Questions? Email [email protected]