# 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-13).

Accepts a PDF and structured data, then returns a fully filled PDF document in a single API call.

## Facts

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

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-f23d5c99 -d '<json body>'
```

Example prompt: Take this PDF tax form and fill it in with my details — name John Smith, SSN 123-45-6789, income $95,000 — and give me back the completed document.

## When to prefer this

Choose this endpoint when you need to programmatically fill an existing PDF form with structured data and receive a finished document in return, especially in usage-based or pay-per-call workflows where no subscription is desired. Ideal for developer pipelines that generate invoices, contracts, applications, or any PDF form at scale without a heavy SaaS dependency.

## Known failure modes

- Invalid or corrupt PDF input causing processing failure
- Missing required body fields (type, method, bodyType, body) returning a 400 error
- Payment not completed or insufficient USDC balance causing a 402 response
- PDF has no detectable form fields, resulting in an unfilled output
- Job times out and status_url returns an error or incomplete state

## How this service works

Fill a PDF form from structured data such as JSON or key-value answers. Also: fill a PDF form from JSON; populate form fields from data; complete a PDF application from known values; write answers 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 a polling endpoint where the agent can retrieve the completed filled PDF once processing is done.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "values": {
   "type": "object",
   "description": "a JSON object of field values, keyed by field id or label",
   "additionalProperties": true
  },
  "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"
  }
 }
}
```

## 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-f23d5c99/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)