canonical: https://jentic.com/apis/cofferdock.com/cofferdock

# Cofferdock API

The Cofferdock API is a toolkit of on-demand document, image, and data operations behind one key. It converts HTML and Markdown to PDF or images, manipulates PDFs by merging, splitting, rotating, compressing, watermarking, and password-protecting them, and transforms images by resizing, converting, watermarking, and reading or stripping EXIF metadata. It also converts tabular data between CSV, JSON, and Excel, runs OCR on images and scanned PDFs, generates QR codes, barcodes, charts, hashes, and UUIDs, and validates emails, phone numbers, IBANs, and more. Every tool shares one account and a single monthly pool of credits.

## For AI agents

Convert HTML, Markdown, images, and tabular data between formats, manipulate and OCR PDFs, generate QR codes and barcodes, and validate emails, phones, and IBANs, all behind one key. Tools share a single credit pool.

## Scope

Does not store files long-term, host documents, or send email. Use for on-demand document, image, and data conversion, OCR, generation, and validation only.

## Capabilities

- Convert documents between formats: HTML or Markdown to PDF or image, and images to or from PDF
- Manipulate PDFs by merging, splitting, rotating, compressing, watermarking, and password-protecting them
- Transform images by resizing, converting, watermarking, and reading or stripping EXIF metadata
- Convert tabular data between CSV, JSON, and Excel and render it as a table image or PDF
- Read text from images and scanned PDFs with OCR
- Generate QR codes, barcodes, charts, hashes, UUIDs, and URL slugs
- Validate emails, phone numbers, IBANs, credit card numbers, URLs, and Spanish tax IDs

## Use cases

### Document and Data Tools Through Jentic

An AI agent that needs to produce or process files can call Cofferdock through Jentic instead of integrating each tool by hand. The agent converts an HTML report to PDF, merges it with another document, runs OCR on a scanned attachment, and validates the email it will send it to, all behind one key. Because every tool takes its input in the request body, the agent's reach is bounded by the operations you allow.

Example prompt: Convert an HTML report to PDF, merge it with an existing PDF, and return the combined file

### Document Generation and PDF Processing

A workflow can build and process documents end to end: render HTML or Markdown to PDF, add page numbers and a watermark, merge or split pages, compress the result, and protect it with a password. OCR turns a scanned PDF into searchable text when the source is an image.

Example prompt: Render a Markdown invoice to PDF, add page numbers, watermark it, and password-protect the final file

### Data Format Conversion

Cofferdock moves tabular and text data between formats so a pipeline does not need its own parsers. It converts CSV to JSON and back, reads an Excel sheet to JSON, writes JSON to Excel, turns Markdown into HTML, and renders data as a table image or PDF.

Example prompt: Convert an uploaded CSV file to JSON and render the same data as a table image

### Input Validation for Forms and Agents

Before acting on user-supplied data, an agent can validate it with Cofferdock. It checks email addresses, phone numbers, IBANs, credit card numbers, URLs, and Spanish tax IDs, and measures password strength, so a workflow can reject bad input early.

Example prompt: Validate a submitted email address, phone number, and IBAN and return which ones are valid

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | `/pdf` | Convert HTML to PDF |
| POST | `/pdf-merge` | Merge 2 to 20 PDFs into one |
| POST | `/image-ocr` | Read text from an image with OCR |
| POST | `/screenshot` | Screenshot a public web page |
| POST | `/csv-to-json` | Convert CSV to JSON |
| POST | `/qr` | Generate a QR code |
| POST | `/validate-email` | Validate an email address |
| GET | `/status` | Check your plan and remaining credits |

## Key resources

- **Document Conversion** — HTML and Markdown to PDF or image, images to and from PDF, and web page screenshots
- **PDF Tools** — Merge, split, rotate, compress, watermark, protect, fill forms, add page numbers, and OCR PDFs
- **Image Tools** — Resize, convert, watermark, collage, read or strip EXIF metadata, and OCR images
- **Data Conversion** — CSV, JSON, and Excel conversions and rendering data as a table image or PDF
- **Generators and Validators** — QR codes, barcodes, charts, hashes, UUIDs, slugs, and email, phone, IBAN, card, URL, and tax ID validation

## AI readiness

This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.

- **Score:** 59 / 100
- **Maturity:** Foundational
- **Dimensions:**
  - Foundational Compliance: 48 / 100
  - Developer Experience & Jentic Compatibility: 68 / 100
  - AI-Readiness & Agent Experience: 45 / 100
  - Agent Usability: 94 / 100
  - Security: 50 / 100
  - AI Discoverability: 78 / 100
- **View full report:** https://jentic.com/apis/cofferdock.com/cofferdock/scorecard
- **How the score is calculated:** https://docs.jentic.com/reference/api-readiness-framework/overview/
- **More about the dimensions:** https://docs.jentic.com/reference/api-readiness-framework/specification/#dimensional-model-overview

### Score it yourself

Every API in the directory is allowlisted, so you can re-score it with no key required.

- **Score your own API:** https://jentic.com/scorecard.md
- **Scoring CLI agent skill:** https://github.com/jentic/jentic-api-scorecard/blob/main/skills/jentic-api-scorecard/SKILL.md

```sh
npx @jentic/api-scorecard-cli score <openapi-url>
```

## Why Jentic

- **Setup:** Wiring the Cofferdock API by hand means passing your key in the x-api-key header, choosing whether to send each file as base64 JSON or raw bytes, and watching the shared monthly credit pool. Through Jentic you install once, import Cofferdock from the API Directory, store the key once, and your agent calls it.
- **Permission scoping:** Cofferdock takes each file or input in the request body, so rules bound which operations your agent may call, not which file it acts on. Limit it to the tools it needs, such as the PDF and image operations, so others like password removal or metadata writing are not included unless you add them.
- **Credential handling:** Your Cofferdock key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as convert HTML to PDF or read text from an image, and Jentic returns the matching Cofferdock operation with its input schema so the agent calls the right endpoint without reading the reference docs.

## Related APIs

- **CloudConvert** — A dedicated file conversion service covering a very broad set of formats.
- **Abstract API** — A suite of utility APIs including validation and data tools, similar in spirit to Cofferdock.
- **Urlbox** — A dedicated screenshot renderer with more control than Cofferdock's screenshot tool.

## FAQ

### What authentication does the Cofferdock API use?

The Cofferdock API authenticates with an API key in the x-api-key header, per its OpenAPI spec; a status operation returns your plan and remaining credits. Through Jentic the key is stored encrypted by your own Jentic One instance and injected at call time, so it never reaches the agent's context.

### What document and image tools does the Cofferdock API offer?

It converts HTML or Markdown to PDF, merges, splits, rotates, compresses, watermarks, and password-protects PDFs, runs OCR on images and scanned PDFs, and resizes, converts, or watermarks images. It also generates QR codes, barcodes, charts, and collages, and converts between CSV, JSON, and Excel.

### Is the Cofferdock API free, and how is usage counted?

All tools share one account and one monthly pool of credits, where one successful call costs one credit and failed calls are not charged, per the API's own notes. A free plan is available; check the vendor documentation at https://cofferdock.com for current plan limits.

### How do I convert a document with the Cofferdock API through Jentic?

Install Jentic One, then import Cofferdock from the API Directory and store your key once. Your agent searches by intent such as convert HTML to PDF, and Jentic returns the matching operation with its input schema so the agent sends the input and gets the output file or data back. To run it on your own infrastructure, install Jentic One from its GitHub repo.

### Is there a Cofferdock API MCP server?

You don't need an MCP server to give your agent the Cofferdock API. Jentic connects it directly from the API Directory: import it, store your key once, and your agent calls the conversion, PDF, and image operations on demand. Operations are discovered when the agent needs them, so they do not fill its context ahead of time.

### Can I limit what my agent is allowed to do with the Cofferdock API?

Yes. Cofferdock carries each input in the request body, so a rule bounds which of its tools your agent may call. Allow only the operations it needs, such as HTML-to-PDF and image OCR, and the rest of the toolkit stays out of reach. Every call the agent makes is logged.
