{
  "openapi": "3.0.3",
  "info": {
    "title": "PDF Form Filling API",
    "version": "1.5.1",
    "description": "Read the fields of a fillable PDF, fill them from JSON with a per-field report and flatten the result. Read the name, type, current value and options of every field of a fillable PDF form, fill text, checkbox, dropdown, radio and option-list fields from JSON, and flatten a PDF so the filled values can no longer be edited. Only the fields you name change: a partial fill keeps every other value, and a field is cleared only when you send null or an empty value on purpose. The response reports which fields were set and which were not, with the reason for each. Limits: AcroForm fields only (no XFA dynamic forms), text in Latin-1 characters, push buttons and signature fields cannot be filled, 20 MB per file. The file is processed in memory and nothing is stored. One X-API-Key header authenticates every call, and the same key works across every FreeDailyPro API. Every 4xx response is documented and none of them is billed.",
    "contact": {
      "name": "FreeDailyPro",
      "url": "https://www.freedailypro.com/developers",
      "email": "support@freedailypro.com"
    },
    "termsOfService": "https://www.freedailypro.com/terms",
    "x-logo": {
      "url": "https://www.freedailypro.com/favicon.ico"
    }
  },
  "servers": [
    {
      "url": "https://api.freedailypro.com",
      "description": "Production"
    }
  ],
  "externalDocs": {
    "description": "Developer hub, plans and MCP setup",
    "url": "https://www.freedailypro.com/developers"
  },
  "components": {
    "securitySchemes": {
      "ApiKeyAuth": {
        "type": "apiKey",
        "in": "header",
        "name": "X-API-Key"
      }
    }
  },
  "tags": [
    {
      "name": "PDF Forms",
      "description": "Read the fields of a fillable PDF, fill them from JSON with a per-field report and flatten the result."
    }
  ],
  "paths": {
    "/v1/fillable-forms/parse": {
      "post": {
        "summary": "List the fillable fields in a PDF form",
        "operationId": "fillableFormsParse",
        "description": "Returns every fillable field of a PDF form: name, type (text, checkbox, dropdown, radio, optionlist, or button/signature for fields that cannot be filled), current value, options for dropdowns, radio groups and option lists, and flags (readOnly, required, maxLength and multiline for text, editable for dropdowns, multiselect for option lists). kind is the same word as type (kept for existing clients). Use it before fill to get the exact names and option values. Limits: reads AcroForm fields only; XFA (dynamic) forms and PDFs with no fields return an empty list or a 422. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PDF Forms"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The PDF form. Up to 20 MB."
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.pdf"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "Success",
            "content": {
              "application/json": {
                "schema": {
                  "type": "object"
                },
                "example": {
                  "fieldCount": 6,
                  "fields": [
                    {
                      "name": "name",
                      "kind": "text",
                      "type": "text",
                      "readOnly": false,
                      "required": false,
                      "value": "Jane Doe",
                      "multiline": false
                    },
                    {
                      "name": "email",
                      "kind": "text",
                      "type": "text",
                      "readOnly": false,
                      "required": false,
                      "value": "",
                      "multiline": false
                    },
                    {
                      "name": "agree",
                      "kind": "checkbox",
                      "type": "checkbox",
                      "readOnly": false,
                      "required": false,
                      "checked": false,
                      "value": false
                    },
                    "..."
                  ]
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods. Not billed: a failed call does not count against your plan's calls."
          },
          "422": {
            "description": "The file could not be processed (corrupted, password protected or an unsupported format); the body explains why Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    },
    "/v1/fillable-forms/fill": {
      "post": {
        "summary": "Fill a PDF form's fields from JSON and return the filled PDF",
        "operationId": "fillableFormsFill",
        "description": "Fills the fields you name and returns the PDF. Only the fields named in values or checked change; every other field keeps its current value (a partial fill never erases the rest). Supported field types: text (string), checkbox (true or false, in checked or values), dropdown (one of its options), radio group (one of its options) and option list (one option or an array when it allows several). To clear a field on purpose send null (or an empty string for text, dropdown, radio and option list; false for a checkbox). Dropdown, radio and option-list values are matched to the option exactly, or ignoring case and surrounding spaces when that is unambiguous. A field that cannot be set is reported with the reason: in the X-Fields-Not-Set and X-Fields-Not-Set-Detail response headers, or in the body when you send format=json (fieldsSet, fieldsNotSet, fieldsUntouched, plus the PDF as fileBase64). If none of the named fields could be set the call returns 422 with the same report and is not billed. flatten=true burns the values in so they can no longer be edited (done after filling). Limits: AcroForm fields only (no XFA); text must be Latin-1 (WinAnsi) characters, other scripts are reported as not set; push buttons and signature fields cannot be filled; the output uses the form's standard appearance, so very custom field fonts may look different in some viewers. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PDF Forms"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The PDF form. Up to 20 MB."
                  },
                  "values": {
                    "type": "string",
                    "description": "JSON object of field values by field name, for example {\"Name\":\"Ada\",\"Country\":\"Canada\",\"Plan\":\"Pro\"}. A string for text, dropdown and radio; a string or array of strings for an option list; true/false for a checkbox; null clears the field. Fields not named here are not changed"
                  },
                  "checked": {
                    "type": "string",
                    "description": "JSON object of checkbox states, for example {\"Agree\":true}. Only the named checkboxes change"
                  },
                  "flatten": {
                    "type": "string",
                    "description": "true to flatten the form so it can no longer be edited"
                  },
                  "format": {
                    "type": "string",
                    "description": "Send json to get a JSON body with the fill report and the PDF as base64 instead of the PDF file",
                    "enum": [
                      "pdf",
                      "json"
                    ]
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "form.pdf",
                "values": "{\"name\":\"Jane Doe\",\"plan\":\"Pro\"}",
                "checked": "{\"agree\":true}"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/pdf, 7,487 bytes.",
            "content": {
              "application/pdf": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            },
            "headers": {
              "X-Fields-Set": {
                "schema": {
                  "type": "string"
                },
                "description": "Number of fields changed by this call",
                "example": "3"
              },
              "X-Fields-Not-Set": {
                "schema": {
                  "type": "string"
                },
                "description": "Number of named fields that could not be set",
                "example": "0"
              },
              "X-Fields-Not-Set-Detail": {
                "schema": {
                  "type": "string"
                },
                "description": "URL-encoded JSON list of {name, reason} for the fields that could not be set (shortened to 3,000 characters)",
                "example": "%5B%5D"
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods. Not billed: a failed call does not count against your plan's calls."
          },
          "422": {
            "description": "The file could not be processed (corrupted, password protected or an unsupported format); the body explains why Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    },
    "/v1/pdf/flatten": {
      "post": {
        "summary": "Flatten a PDF's form fields into fixed text and return the PDF",
        "operationId": "pdfFlatten",
        "description": "Turns form fields and annotations into fixed page content. The file is processed in memory and nothing is stored. Use POST with multipart/form-data (opening the URL in a browser sends GET and returns 405). Common errors: 400 missing or invalid field, 422 the file could not be processed (corrupted or password protected), 405 use POST, not GET.",
        "tags": [
          "PDF Forms"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "multipart/form-data": {
              "schema": {
                "type": "object",
                "properties": {
                  "file": {
                    "type": "string",
                    "format": "binary",
                    "description": "The PDF. Up to 20 MB."
                  }
                },
                "required": [
                  "file"
                ]
              },
              "example": {
                "file": "sample.pdf"
              }
            }
          }
        },
        "security": [
          {
            "ApiKeyAuth": []
          }
        ],
        "responses": {
          "200": {
            "description": "The processed file. Real example: 200, application/pdf, 7,139 bytes.",
            "content": {
              "application/pdf": {
                "schema": {
                  "type": "string",
                  "format": "binary"
                }
              }
            }
          },
          "400": {
            "description": "Missing or invalid input; the body explains what to fix Not billed: a failed call does not count against your plan's calls."
          },
          "401": {
            "description": "Missing or invalid API key Not billed: a failed call does not count against your plan's calls."
          },
          "405": {
            "description": "Wrong HTTP method: this endpoint takes POST with multipart/form-data. The Allow header lists the accepted methods. Not billed: a failed call does not count against your plan's calls."
          },
          "422": {
            "description": "The file could not be processed (corrupted, password protected or an unsupported format); the body explains why Not billed: a failed call does not count against your plan's calls."
          },
          "429": {
            "description": "Rate limit exceeded for your plan Not billed: a failed call does not count against your plan's calls."
          }
        }
      }
    }
  }
}