# Emboss PDF Form-Filling API

> Emboss PDF Form-Filling API is a paid API for AI agents from api.getemboss.ai, paid per call via x402, $0.07/call, status unknown (last checked 2026-09-15).

Fills a PDF form with provided data in a single API call, returning a completed document

## Facts

- Endpoint: POST https://api.getemboss.ai/pay/fill-with-context
- Price: $0.07/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-15
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/emboss-pdf-form-filling-api-c98d5f9e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_tj4x5HMADXp7xj0Jzbobo

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability emboss-pdf-form-filling-api-c98d5f9e -d '<json body>'
```

Example prompt: Fill out this PDF tax form with my client's data — name: Jane Smith, EIN: 12-3456789, total income: $85,000 — and give me back the completed document.

## When to prefer this

Choose this endpoint when you need to programmatically fill a PDF form with structured data in a single API call without a subscription — ideal for usage-based, pay-per-document workflows. It is well-suited for developers building document automation pipelines, one-off form completion tasks, or integrating PDF filling into agent workflows with usage-based pricing at $0.07 per call.

## Known failure modes

- Invalid or non-fillable PDF input returns an error
- Missing required body fields (type, method, bodyType, body) cause a 400 validation error
- Payment not completed or insufficient funds results in a 402 response
- Large or complex PDFs may take longer and status must be polled via status_url
- Malformed JSON body type causes parsing failure
- Unsupported HTTP method (not POST/PUT/PATCH) rejected

## How this service works

Fill a PDF form using facts found in supporting documents. Also: fill a PDF form from DOCX, spreadsheets, images, JSON, or other documents; pre-fill a government form from supporting paperwork; complete an application from a resume or company details; extract answers from context documents into a form. Price scales with page count; this 402 carries the exact amount for the PDF sent.

## Output

Returns a JSON object containing a job_id (UUID), a quote_id (UUID), and a status_url pointing to the job status endpoint where the completed filled PDF can be retrieved once processing finishes.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "mode": {
   "enum": [
    "one_call",
    "two_call"
   ],
   "type": "string",
   "description": "one_call (default) returns the finished PDF; two_call returns a proposal and a commit token so the caller can resolve open items before anything is written"
  },
  "policy": {
   "enum": [
    "safe",
    "strict"
   ],
   "type": "string",
   "description": "how sure Emboss must be before writing a value: safe (default) writes high and medium confidence, strict writes high only"
  },
  "package": {
   "type": "boolean",
   "description": "mode=two_call only: also produce a submission package at commit, priced into this quote"
  },
  "pdf_url": {
   "type": "string",
   "format": "uri",
   "description": "public https URL of the PDF form to process"
  },
  "pdf_base64": {
   "type": "string",
   "description": "the PDF form as base64 (alternative to pdf_url)",
   "contentEncoding": "base64"
  },
  "context_text": {
   "type": "string",
   "description": "free text with the facts to fill from"
  },
  "context_urls": {
   "type": "array",
   "items": {
    "type": "string",
    "format": "uri"
   },
   "description": "public https links to supporting documents, repeatable"
  },
  "context_base64": {
   "type": "array",
   "items": {
    "type": "object",
    "required": [
     "name",
     "base64"
    ],
    "properties": {
     "name": {
      "type": "string"
     },
     "base64": {
      "type": "string",
      "contentEncoding": "base64"
     }
    }
   },
   "description": "supporting documents as base64, repeatable"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "job_id": "<uuid>",
  "quote_id": "<uuid>",
  "status_url": "https://api.getemboss.ai/pay/jobs/<uuid>?token=<token>"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/emboss-pdf-form-filling-api-c98d5f9e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.getemboss.ai](https://www.zero.xyz/host/api.getemboss.ai/llms.txt)