Standard API

Send a PDF. Get back a watermarked PDF with your branding on every page.

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 PDF file
B	`file`	File (multipart form-data)	Direct file upload (PDF)

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

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

Response

Returns a watermarked PDF file (binary stream) with your branding

Content-Type: application/pdf
File is streamed directly to you (not stored on our servers)

Important

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

Files never stored. Your PDF 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]`
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

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]