# Emboss

Emboss is a PDF form-filling API for developers. Upload a flat PDF and Emboss detects the fields, builds a JSON contract, and returns a filled, fillable PDF. Authenticate every request with a Bearer API key.

## Pricing
Usage-based — pay per form, no subscription. Extraction and fill are billed separately, with a free tier. See https://getemboss.ai/pricing.

## Try it in the browser
Fill a PDF form without code (upload form + context docs, download the filled PDF): https://getemboss.ai/fill
Batch fill PDF forms from a spreadsheet (upload one form + a CSV/Excel, get one filled PDF per row as a ZIP): https://getemboss.ai/batch-fill

## Documentation
- [Quickstart](https://getemboss.ai/docs/quickstart)
- [Authentication](https://getemboss.ai/docs/authentication)
- [How Emboss works](https://getemboss.ai/docs/how-emboss-works)
- [Fill from your data](https://getemboss.ai/docs/fill-from-data)
- [Fill from context docs](https://getemboss.ai/docs/fill-from-context)
- [Batch fill](https://getemboss.ai/docs/batch-fill)
- [Bulk runs](https://getemboss.ai/docs/bulk-runs)
- [The contract shape](https://getemboss.ai/docs/the-contract-shape)
- [Tracking jobs](https://getemboss.ai/docs/tracking-jobs)
- [Callbacks](https://getemboss.ai/docs/callbacks)
- [Create a form](https://getemboss.ai/docs/reference/create-form)
- [Get the contract](https://getemboss.ai/docs/reference/get-contract)
- [Fill with context](https://getemboss.ai/docs/reference/fill-with-context)
- [Batch fill](https://getemboss.ai/docs/reference/batch)
- [Standard fill](https://getemboss.ai/docs/reference/sessions)
- [Usage](https://getemboss.ai/docs/reference/usage)
- [Errors](https://getemboss.ai/docs/reference/errors)

## API
Base host: https://api.getemboss.ai
- POST /forms — Create a form (auth required)
- GET /forms/{id} — Get a form (auth required)
- GET /forms/{id}/contract — Get the contract (auth required)
- POST /forms/{form_id}/with-context — Fill an existing form with context (auth required)
- POST /forms/with-context — Fill with context (auth required)
- GET /forms/with-context/{job_id} — Get the fill job (auth required)
- POST /forms/{form_id}/suggest-mapping — Suggest a column mapping (auth required)
- POST /forms/{form_id}/fill-batch — Start a batch fill (auth required)
- GET /forms/fill-batch/{batch_id} — Get batch status (auth required)
- GET /forms/fill-batch/{batch_id}/rows/{n}/pdf — Download a row PDF (auth required)
- GET /forms/fill-batch/{batch_id}/zip — Download all rows as ZIP (auth required)
- POST /sessions — Create a session (auth required)
- GET /sessions/{id} — Get session state (auth required)
- POST /sessions/{id}/confirm — Confirm a field (auth required)
- POST /sessions/{id}/skip — Skip a field (auth required)
- POST /sessions/{id}/decline — Decline a field (auth required)
- PUT /sessions/{id}/fields — Direct field fill (auth required)
- POST /sessions/{id}/fill — Render the filled PDF (auth required)
- GET /sessions/{id}/pdf — Download the PDF (auth required)
- GET /usage — Usage (auth required)
- GET /health — Health (public)

## Integrations
- [Integrations](https://getemboss.ai/integrations) — Plug Emboss into your automation stack, or build your own integration on the API.
- [n8n](https://getemboss.ai/integrations/n8n) — Fill PDF forms in n8n workflows.
- [Pipedream](https://getemboss.ai/integrations/pipedream) — Fill PDF forms in Pipedream workflows.
- [Zapier](https://getemboss.ai/integrations/zapier) — Fill PDF forms in Zapier workflows.
- [Make](https://getemboss.ai/integrations/make) — Fill PDF forms in Make scenarios.

## Use cases
- [Fill PDFs from your data via API](https://getemboss.ai/use-cases/fill-pdfs-from-your-data)
- [Bulk-fill PDF forms with the API](https://getemboss.ai/use-cases/bulk-fill-pdfs)
- [Batch fill PDF forms from a spreadsheet](https://getemboss.ai/use-cases/batch-fill-from-spreadsheet)
- [Turn a flat PDF into a fillable form via API](https://getemboss.ai/use-cases/flat-pdf-to-fillable)
- [Pre-fill PDF forms from context documents via API](https://getemboss.ai/use-cases/prefill-from-context)

## Glossary
- [Fillable PDF](https://getemboss.ai/glossary/fillable-pdf)
- [Flat vs. fillable PDF](https://getemboss.ai/glossary/flat-vs-fillable-pdf)
- [Form field detection](https://getemboss.ai/glossary/form-field-detection)
- [PDF form](https://getemboss.ai/glossary/pdf-form)
- [AcroForm](https://getemboss.ai/glossary/acroform)
- [Form flattening](https://getemboss.ai/glossary/pdf-form-flattening)
- [Signature field](https://getemboss.ai/glossary/pdf-signature-field)
- [OCR for forms](https://getemboss.ai/glossary/ocr-for-forms)
- [Checkbox and radio fields](https://getemboss.ai/glossary/pdf-checkbox-field)
- [Filling a PDF from data](https://getemboss.ai/glossary/fill-pdf-from-data)