# Tanod Docs PDF Form Fields Extractor

> Tanod Docs PDF Form Fields Extractor is a paid API for AI agents from docs.tanod.dev, paid per call via x402, $0.005/call, status unknown (last checked 2026-10-13).

Extracts all form field definitions (name, type, options, required status, current value) from a PDF document

## Facts

- Endpoint: POST https://docs.tanod.dev/v1/pdf/form-fields?utm_source=zero.xyz
- Price: $0.005/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/tanod-docs-pdf-form-fields-extractor-31b99d24
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_vOO2Yjy3F1E4SCvktdrca

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability tanod-docs-pdf-form-fields-extractor-31b99d24 -d '<json body>'
```

Example prompt: Can you look at the PDF form at https://example.com/application-form.pdf and tell me all the fields it contains — their names, types, whether they're required, and any options for dropdowns or radio buttons?

## When to prefer this

Use this endpoint when you need to discover or inspect the structure of a fillable PDF form before filling it programmatically, building a UI equivalent, or validating that required fields are present. Prefer this over OCR-based approaches when the PDF has actual interactive AcroForm fields. Choose this before calling a PDF fill endpoint to understand what field names and types to target.

## Known failure modes

- PDF URL is inaccessible, private, or IP-literal host — request refused
- PDF exceeds 20 MB (URL) or 10 MB decoded (base64) — size limit error
- Neither url nor pdf_base64 provided — validation error
- PDF has no interactive form fields — returns has_form: false with empty fields array
- Malformed or encrypted PDF — parsing failure
- URL returns non-PDF content — type error

## How this service works

Documents: DOCX template fill, Office to PDF, any file to Markdown, PDF to Word, OCR, PDF pipeline.

## Output

Returns a JSON object listing all interactive form fields found in the PDF, including each field's name, page number, type (text, checkbox, radio, choice), current value, required flag, read-only flag, description label, and available options for choice/radio fields. Also includes summary metadata: whether XFA is used, total field count, page count, input byte size, and whether the content is flagged as untrusted.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "url": {
   "anyOf": [
    {
     "type": "string",
     "maxLength": 2048,
     "minLength": 1
    },
    {
     "type": "null"
    }
   ],
   "default": null,
   "description": "Public http(s) URL of the PDF (at most 20 MB; private, internal and IP-literal hosts are refused); or use pdf_base64."
  },
  "pdf_base64": {
   "anyOf": [
    {
     "type": "string",
     "maxLength": 13398872,
     "minLength": 1
    },
    {
     "type": "null"
    }
   ],
   "default": null,
   "description": "The PDF as base64 (at most 10 MB decoded per request); or use url."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "xfa": false,
  "fields": [
   {
    "name": "full_name",
    "page": 1,
    "type": "text",
    "value": "",
    "required": true,
    "read_only": false,
    "description": "Your full name"
   },
   {
    "name": "email",
    "page": 1,
    "type": "text",
    "value": "",
    "required": false,
    "read_only": false,
    "description": "Your email address"
   },
   {
    "name": "plan",
    "page": 1,
    "type": "radio",
    "value": null,
    "options": [
     "basic",
     "pro"
    ],
    "required": false,
    "read_only": false,
    "description": "Subscription plan"
   },
   {
    "name": "country",
    "page": 1,
    "type": "choice",
    "value": null,
    "options": [
     "AU",
     "NZ",
     "PH"
    ],
    "required": false,
    "list_type": "combo",
    "read_only": false,
    "description": "Country",
    "option_labels": [
     "Australia",
     "New Zealand",
     "Philippines"
    ]
   },
   {
    "name": "subscribe",
    "page": 1,
    "type": "checkbox",
    "value": false,
    "on_value": "Yes",
    "required": false,
    "read_only": false,
    "description": "Send me the newsletter"
   },
   {
    "name": "notes",
    "page": 1,
    "type": "text",
    "value": "",
    "required": false,
    "multiline": true,
    "read_only": false,
    "description": "Anything else we should know"
   }
  ],
  "has_form": true,
  "operation": "form-fields",
  "truncated": false,
  "field_count": 6,
  "input_bytes": 4057,
  "input_pages": 1,
  "need_appearances": false,
  "untrusted_content": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/tanod-docs-pdf-form-fields-extractor-31b99d24/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from docs.tanod.dev](https://www.zero.xyz/host/docs.tanod.dev/llms.txt)