{"uid":"cap_jLRLDTnQDNdER7VQ5ovqy","slug":"emboss-pdf-form-filling-api-read-submit-endpoint-fbdfcb95","name":"Emboss PDF Form-Filling API — Read/Submit Endpoint","description":"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.","url":"https://api.getemboss.ai/pay/read?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"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"}}},"responseSchema":{"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>"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_0mtZMYEZaKWIYbxo397iE","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"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.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Automated government application filing","prompt":"I need to fill out this blank IRS W-9 form automatically. The PDF is at https://example.com/w9_blank.pdf — submit it to Emboss so it can propose and fill in my details and return a completed version with a receipt."},{"title":"Legal contract form completion","prompt":"We have a standard lease agreement PDF at https://legalforms.example.com/lease_blank.pdf that needs to be filled in with our tenant's data. Can you kick off the Emboss form-filling process and get me back the job ID and proposal link?"},{"title":"Insurance claim form processing","prompt":"Here's a blank insurance claim form as a base64 PDF — can you send it to Emboss to have it automatically filled out with source-cited answers and return the completed form receipt and proposal URL?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-17T06:36:01.725Z","isFirstParty":false,"canonicalSlug":"emboss-pdf-form-filling-api-read-submit-endpoint-fbdfcb95"}