{"uid":"cap_tj4x5HMADXp7xj0Jzbobo","slug":"emboss-pdf-form-filling-api-c98d5f9e","name":"Emboss PDF Form-Filling API","description":"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.","url":"https://api.getemboss.ai/pay/fill-with-context","method":"POST","headers":{},"bodySchema":{"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"}}},"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.08","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","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_bC5LsARuKNloVmMLrFcW4","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":"Fills a PDF form with provided data in a single API call, returning a completed document","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Automated contract generation for SaaS","prompt":"I have a standard NDA PDF and a list of client details — company name, address, and signatory — can you fill out the NDA form for each client and return the completed PDFs?"},{"title":"Government form submission prep","prompt":"Take this IRS W-9 PDF form and fill it in with my vendor's details: business name TechCorp LLC, tax classification S-Corp, and EIN 98-7654321, then give me the filled form."},{"title":"Insurance application document flow","prompt":"We have an insurance application PDF and the applicant's information from our database — can you populate all the form fields and return the finished application document?"}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:30:27.809Z","isFirstParty":false}