80trust / 100
Pdf Fill Form
by Tanod pdfpeek in Documents & files
x402 APIPassing, checked 4 h ago
pdfpeek (Tanod) PDF form fill: fields set from a JSON object, appearances drawn, optional flatten.
POST https://tanod.dev/v1/pdf/fill-form
Last 30 days
All checks passedSome failedAll failedNot checked
- Uptime
- 100%
- Response time
- 280 ms typical, 815 ms slowest 5%
- Last check
- 4 h ago
- Next check
- any minute now
How to call it
POST https://tanod.dev/v1/pdf/fill-form
Each call costs $0.01 in USDC on Base, paid with the request over x402.
Run a free test callOne unpaid request, the way an agent sends it. You see the payment challenge it gets back. Nothing is charged.
Example request
From the listing.
POST https://tanod.dev/v1/pdf/fill-form
content-type: application/json
{
"fields": {
"country": "Australia",
"email": "[email protected]",
"full_name": "Ada Lovelace",
"plan": "pro",
"subscribe": true
},
"url": "https://tanod.dev/samples/form-sample.pdf"
}Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
fields | object | Yes | Field name -> value, the names as listed by form-fields (at most 500 fields). Text fields: a string (or a number); checkbox: true / false (or its on value); radio group: one of its options; choice field: one of its values or labels (a list of them for a multi-select list box); null clears a field. … |
flatten | boolean | No | Bake the values into the pages and remove the form (default false: the form stays fillable). Default: false. |
pdf_base64 | string or null | No | The PDF as base64 (at most 10 MB decoded per request); or use url. Default: null. |
url | string or null | No | Public http(s) URL of the PDF (at most 20 MB; private, internal and IP-literal hosts are refused); or use pdf_base64. Default: null. |
Example response
The provider's example. We can't check it without paying.
Example response, 27 lines
{
"active_content_removed": {},
"appearances_drawn": 3,
"file": {
"bytes": 5160,
"content_type": "application/pdf",
"data_base64": "JVBERi0xLjMKJb/3... (trimmed: 6,880 base64 characters in the reply)",
"name": "filled.pdf",
"pages": 1
},
"filled_count": 5,
"filled_fields": [
"country",
"email",
"full_name",
"plan",
"subscribe"
],
"flattened": false,
"input_bytes": 4057,
"input_pages": 1,
"need_appearances": false,
"operation": "fill-form",
"output_bytes": 5160,
"untrusted_content": true,
"warnings": []
}Call it from code
The curl command shows the payment challenge. The JavaScript and Python versions pay and call, and never pay more than $0.01.
curl: see the payment challenge
# bash or zsh: see the payment challenge. Nothing is charged.
curl -sS -g -i -X POST 'https://tanod.dev/v1/pdf/fill-form' \
-H 'content-type: application/json' \
--data-raw '{"fields":{"country":"Australia","email":"[email protected]","full_name":"Ada Lovelace","plan":"pro","subscribe":true},"url":"https://tanod.dev/samples/form-sample.pdf"}'
# x402 v2 sends the challenge base64-encoded in the PAYMENT-REQUIRED header (v1 sends it in the body).
# To read the header:
curl -sS -g -o /dev/null -D - -X POST 'https://tanod.dev/v1/pdf/fill-form' \
-H 'content-type: application/json' \
--data-raw '{"fields":{"country":"Australia","email":"[email protected]","full_name":"Ada Lovelace","plan":"pro","subscribe":true},"url":"https://tanod.dev/samples/form-sample.pdf"}' \
| grep -i '^payment-required:' | cut -d' ' -f2 | tr -d '\r' | base64 --decodeJavaScript: pay and call
// npm i @x402/fetch @x402/evm viem
import { wrapFetchWithPayment, x402Client } from "@x402/fetch";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";
// Pays at most $0.01 per call.
const client = new x402Client().setSpendControls({ maxAmountPerPayment: "$0.01" });
registerExactEvmScheme(client, { signer: privateKeyToAccount(process.env.EVM_PRIVATE_KEY) });
const pay = wrapFetchWithPayment(fetch, client);
// Not sure it's safe to pay? ToolVet checks it first for $0.005. Pay for that from a separate
// client: this one is capped at $0.01 per payment. GET https://toolvet.app/api/v1/check?url=https%3A%2F%2Ftanod.dev%2Fv1%2Fpdf%2Ffill-form&method=POST
const res = await pay("https://tanod.dev/v1/pdf/fill-form", {
method: "POST",
headers: { "content-type": "application/json" },
body: JSON.stringify({
"fields": {
"country": "Australia",
"email": "[email protected]",
"full_name": "Ada Lovelace",
"plan": "pro",
"subscribe": true
},
"url": "https://tanod.dev/samples/form-sample.pdf"
}),
});
console.log(res.status, await res.text());Python: pay and call
# pip install "x402[requests,evm]"
import os
from eth_account import Account
from x402 import x402ClientSync
from x402.http.clients import x402_requests
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact.register import register_exact_evm_client
# Pays at most $0.01 per call.
client = x402ClientSync().set_spend_controls({"max_amount_per_payment": "$0.01"})
register_exact_evm_client(client, EthAccountSigner(Account.from_key(os.environ["EVM_PRIVATE_KEY"])))
with x402_requests(client) as session:
res = session.post(
"https://tanod.dev/v1/pdf/fill-form",
json={
"fields": {
"country": "Australia",
"email": "[email protected]",
"full_name": "Ada Lovelace",
"plan": "pro",
"subscribe": True,
},
"url": "https://tanod.dev/samples/form-sample.pdf",
},
)
print(res.status_code, res.text)Security scan
- No findings. We scan names, descriptions and tool definitions for hidden instructions and other prompt-injection patterns.
Recent checks
| When | Result | HTTP | Time | Price |
|---|---|---|---|---|
| 4 h ago | Passed | 402 | 277 ms | $0.01 |
| 8 h ago | Passed | 402 | 476 ms | $0.01 |
| 11 h ago | Passed | 402 | 302 ms | $0.01 |
| 15 h ago | Passed | 402 | 465 ms | $0.01 |
| 19 h ago | Passed | 402 | 1.1 s | $0.01 |
| 23 h ago | Passed | 402 | 298 ms | $0.01 |
| 26 h ago | Passed | 402 | 273 ms | $0.01 |
| 30 h ago | Passed | 402 | 283 ms | $0.01 |
| 33 h ago | Passed | 402 | 277 ms | $0.01 |
| 37 h ago | Passed | 402 | 272 ms | $0.01 |
| 41 h ago | Passed | 402 | 272 ms | $0.01 |
| 44 h ago | Passed | 402 | 270 ms | $0.01 |
| 2 days ago | Passed | 402 | 280 ms | $0.01 |
| 2 days ago | Passed | 402 | 315 ms | $0.01 |
| 2 days ago | Passed | 402 | 815 ms | $0.01 |