Standard API

Send a PDF. Get back a watermarked PDF.

Your workflow, your way. This is a simple endpoint you can integrate anywhere in your system. Whether that's triggered by a button click, automated on document upload, or part of your existing document pipeline is entirely up to you.

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

Required

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

File Input (Choose One)

Parameter	Type	Description
`file_url`	String	PDF URL (recommended - works with CRMs, cloud storage, etc.)
`file`	File Upload	Direct file upload (multipart/form-data)

Choose one file input method. Max 25MB per file.

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

Example: 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

Returns a watermarked PDF file

Example: File Upload

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

Returns a watermarked PDF 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]