{"uid":"cap_KkoRYWeEBmzQPzq31lDGm","slug":"x402-signature-service-electronic-signature-request-2adce55d","name":"x402 Signature Service — Electronic Signature Request","description":"Pay-per-call API (x402, $0.50 USDC on Base): send one PDF to one email recipient for simple electronic signature, track status, download the signed PDF.","url":"https://x402-signature-service.onrender.com/v1/signature-requests","method":"GET","headers":{},"bodySchema":{"type":"object","properties":{"signer":{"type":"object","required":["name","email"],"properties":{"name":{"type":"string","maxLength":120,"minLength":1},"email":{"type":"string","format":"email"}}},"message":{"type":"string","maxLength":2000,"description":"Optional message included in the signature request email"},"documentUrl":{"type":"string","description":"HTTPS URL of the PDF to sign (max 5 MB). Provide either documentUrl OR documentBase64."},"documentName":{"type":"string","maxLength":150,"minLength":1,"description":"Human-readable document title shown to the signer"},"expiresInDays":{"type":"integer","default":14,"maximum":30,"minimum":1,"description":"Days until the signature request expires"},"documentBase64":{"type":"string","description":"Base64-encoded PDF (max 5 MB decoded). Provide either documentUrl OR documentBase64."},"externalReference":{"type":"string","maxLength":200,"description":"Optional caller-side reference id, echoed back in responses"}}},"responseSchema":{"type":"json","example":{"id":"sigreq_1f4a9c2b7d3e8a01","signer":{"name":"Anna Müller","email":"a***@example.com"},"status":"sent","createdAt":"2026-07-19T15:00:00Z","expiresAt":"2026-08-02T15:00:00Z","statusUrl":"https://your-api.example.com/v1/signature-requests/sigreq_1f4a9c2b7d3e8a01","accessToken":"sec_… (plain-text bearer token, shown exactly once)","documentName":"Service Agreement"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.5","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.5/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.5","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_BUxb5mgkYmXH0xQadf5UH","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.5","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Sends a PDF document to a named email recipient for electronic signature, returning a tracking ID, status URL, and one-time access token.","exampleAgentPrompt":"Can you send my Service Agreement PDF (at https://files.example.com/service-agreement.pdf) to Anna Müller at anna@example.com for her electronic signature, with the message 'Please review and sign at your earliest convenience', expiring in 14 days?","exampleUseCases":[{"title":"Client contract signing automation","prompt":"Send my consulting contract PDF at https://docs.mycompany.com/consulting-contract.pdf to John Smith at john.smith@clientco.com for his e-signature — include the message 'Please sign this to kick off our engagement' and set it to expire in 7 days."},{"title":"NDA collection before onboarding","prompt":"I need Sarah Connor at sarah@startup.io to sign our NDA before her onboarding call tomorrow. Can you send her the NDA from https://hr.mycompany.com/nda.pdf with the note 'Please sign before your onboarding session' and give her 3 days to complete it?"},{"title":"Freelancer invoice approval","prompt":"Send the project scope agreement at https://files.freelance.io/scope-2024.pdf to my client Mike Torres at mike@torresco.com — title it 'Project Scope Agreement', add the message 'Kindly sign to confirm project terms', and set it to expire in 5 days."}],"resultDescription":"Returns a JSON object containing a unique signature request ID, the signer's name and partially masked email, the current status (e.g. 'sent'), creation and expiration timestamps, a URL to poll for status updates, a one-time plain-text bearer access token for subsequent API calls, and the document name.","failureModes":["Invalid or unreachable PDF URL returns an error (document fetch failure)","PDF exceeds 5 MB size limit causes rejection","Invalid signer email format fails schema validation","Both documentUrl and documentBase64 provided simultaneously causes conflict error","Neither documentUrl nor documentBase64 provided causes missing document error","Payment of $0.50 USDC not included or insufficient triggers 402 Payment Required","Expired or missing x402 payment header blocks request","expiresInDays outside 1–30 range fails validation"],"whenToPreferThis":"Choose this endpoint when you need to send a single PDF document to a single recipient for electronic signature and want a pay-per-call, no-subscription model billed in USDC via the x402 protocol. Ideal for AI agents that need to automate contract or agreement signing without setting up a full e-signature SaaS subscription. Not suitable for bulk multi-recipient signing, non-PDF formats, or when you need advanced signing workflows (field placement, multi-party ordering).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:33:53.971Z","isFirstParty":false}