{"uid":"cap_-DTFrhMEtSxlKxtH26hSs","slug":"emboss-pdf-form-filling-api-f23d5c99","name":"Emboss PDF Form-Filling API","description":"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.","url":"https://api.getemboss.ai/pay/fill","method":"POST","headers":{},"bodySchema":{"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"}}},"responseSchema":{"type":"json","example":{"job_id":"<uuid>","quote_id":"<uuid>","status_url":"https://api.getemboss.ai/pay/jobs/<uuid>?token=<token>"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.07","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.07/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.07","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.07","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_9r53FaJemp470sp-bDIrt","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.07","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bda02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Accepts a PDF and structured data, then returns a fully filled PDF document in a single API call.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Auto-fill legal contract PDFs","prompt":"I have a standard NDA template PDF and a JSON object with the counterparty name, date, and jurisdiction — can you fill in all the fields and hand me back a ready-to-sign PDF?"},{"title":"Generate completed invoice PDFs","prompt":"I need to turn my invoice template PDF into a finished invoice filled with client name Acme Corp, invoice number 1042, amount $3,200, and due date June 15 — produce the filled PDF for me."},{"title":"Populate government application forms","prompt":"I have a W-9 PDF form and all the required fields as structured data — fill in the form automatically and return the completed PDF so I can send it to my client."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-13T18:30:46.055Z","isFirstParty":false}