# Emboss PDF Form-Filling API — Read/Submit Endpoint

> Emboss PDF Form-Filling API — Read/Submit Endpoint is a paid API for AI agents from api.getemboss.ai, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-17).

Accepts a blank PDF form (by URL or base64) and initiates the Emboss pipeline that proposes answers with sources, fills, verifies, and returns a receipt with job and proposal tokens.

## Facts

- Endpoint: POST https://api.getemboss.ai/pay/read?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-17
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/emboss-pdf-form-filling-api-read-submit-endpoint-fbdfcb95
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_jLRLDTnQDNdER7VQ5ovqy

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-read-submit-endpoint-fbdfcb95 -d '<json body>'
```

Example prompt: Can you use Emboss to fill out this blank PDF application form for me? Here's the public URL: https://example.com/application.pdf — pull in my data and give me back the filled version with a receipt.

## When to prefer this

Use this endpoint when you have a blank or partially blank PDF form and want Emboss to automatically propose field answers with sourced citations, fill the form, and return a verifiable receipt. Prefer this over generic PDF manipulation tools when you need source-attribution for each answer and a proposal/review step before finalizing. Best suited for workflows where the PDF form is the primary artifact and structured data or documents will supply the answers.

## Known failure modes

- Invalid or inaccessible PDF URL returns an error (400 or 422)
- PDF is not a form (no detectable fields) — job may complete with empty proposals
- Base64 payload malformed — returns parse error
- Payment not completed via x402 — endpoint returns 402 Payment Required
- Server timeout on large or complex PDFs — job_id may still be returned for async polling
- Both pdf_url and pdf_base64 omitted — validation error

## How this service works

Turn a blank PDF and your data into finished forms. Emboss proposes each answer with its source, fills and verifies the PDF, and returns a receipt.

## Output

Returns a JSON object containing a job_id, status ('ready'), quote_id, a status_url for polling the job, a proposal_id, a commit_token, and a proposal_url where the proposed filled-form answers (with their sources) can be reviewed and confirmed before final delivery.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "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>",
  "status": "ready",
  "quote_id": "<uuid>",
  "status_url": "https://api.getemboss.ai/pay/jobs/<uuid>?token=<token>",
  "proposal_id": "<uuid>",
  "commit_token": "<token>",
  "proposal_url": "https://api.getemboss.ai/proposals/<uuid>?token=<token>"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/emboss-pdf-form-filling-api-read-submit-endpoint-fbdfcb95/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)