blinkpdf-io · Schema
AcroForm.Inspection
Deterministic document, page, logical-field, widget, capability, appearance, and diagnostic metadata for a structurally readable PDF.
PDFDocumentProcessingAPISaaSAutomation
Properties
| Name | Type | Description |
|---|---|---|
| coordinateSystem | object | |
| document | object | |
| pages | array | |
| fields | array | |
| diagnostics | array |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/blinkpdf-io/json-schema/blinkpdf-io-acro-form-inspection-schema.json",
"title": "AcroForm.Inspection",
"description": "Deterministic document, page, logical-field, widget, capability, appearance, and diagnostic metadata for a structurally readable PDF.",
"x-generated": "2026-10-30",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/blinkpdf-io-openapi.json#/components/schemas/AcroForm.Inspection",
"additionalProperties": false,
"type": "object",
"required": [
"coordinateSystem",
"document",
"pages",
"fields",
"diagnostics"
],
"properties": {
"coordinateSystem": {
"additionalProperties": false,
"type": "object",
"required": [
"unit",
"publicSpace",
"pdfSpace"
],
"properties": {
"unit": {
"const": "pt",
"type": "string"
},
"publicSpace": {
"additionalProperties": false,
"type": "object",
"required": [
"box",
"origin",
"xAxis",
"yAxis",
"pageRotationApplied"
],
"properties": {
"box": {
"const": "mediaBox",
"type": "string"
},
"origin": {
"const": "top-left",
"type": "string"
},
"xAxis": {
"const": "right",
"type": "string"
},
"yAxis": {
"const": "down",
"type": "string"
},
"pageRotationApplied": {
"const": false,
"type": "boolean"
}
}
},
"pdfSpace": {
"additionalProperties": false,
"type": "object",
"required": [
"space",
"xAxis",
"yAxis",
"rectOrder"
],
"properties": {
"space": {
"const": "defaultUserSpace",
"type": "string"
},
"xAxis": {
"const": "right",
"type": "string"
},
"yAxis": {
"const": "up",
"type": "string"
},
"rectOrder": {
"const": "minXMinYMaxXMaxY",
"type": "string"
}
}
}
}
},
"document": {
"additionalProperties": false,
"type": "object",
"required": [
"acroFormPresent",
"xfaPresent",
"needAppearances",
"signatureState"
],
"properties": {
"acroFormPresent": {
"type": "boolean"
},
"xfaPresent": {
"type": "boolean"
},
"needAppearances": {
"type": "boolean"
},
"signatureState": {
"type": "string",
"enum": [
"none",
"unsignedFields",
"signed",
"certified"
]
}
}
},
"pages": {
"type": "array",
"items": {
"additionalProperties": false,
"type": "object",
"required": [
"index",
"number",
"width",
"height",
"displayWidth",
"displayHeight",
"mediaBoxPdf",
"cropBoxPdf",
"rotation"
],
"properties": {
"index": {
"minimum": 0,
"type": "integer"
},
"number": {
"minimum": 1,
"type": "integer"
},
"width": {
"exclusiveMinimum": 0,
"type": "number"
},
"height": {
"exclusiveMinimum": 0,
"type": "number"
},
"displayWidth": {
"exclusiveMinimum": 0,
"type": "number"
},
"displayHeight": {
"exclusiveMinimum": 0,
"type": "number"
},
"mediaBoxPdf": {
"$ref": "#/$defs/AcroForm.Inspection.pages.item.mediaBoxPdf"
},
"cropBoxPdf": {
"$ref": "#/$defs/AcroForm.Inspection.pages.item.mediaBoxPdf"
},
"rotation": {
"type": "number",
"enum": [
0,
90,
180,
270
]
}
}
}
},
"fields": {
"type": "array",
"items": {
"anyOf": [
{
"additionalProperties": false,
"type": "object",
"required": [
"index",
"name",
"partialName",
"displayLabel",
"pdfFieldType",
"control",
"capabilities",
"readOnly",
"required",
"noExport",
"widgets",
"kind",
"value",
"multiline",
"password",
"fileSelect",
"spellCheck",
"scroll",
"comb",
"richText",
"alignment",
"text"
],
"properties": {
"index": {
"minimum": 0,
"type": "integer"
},
"name": {
"minLength": 1,
"type": "string"
},
"partialName": {
"type": "string"
},
"alternateName": {
"type": "string"
},
"mappingName": {
"type": "string"
},
"displayLabel": {
"$ref": "#/$defs/AcroForm.Inspection.fields.item.text.displayLabel"
},
"pdfFieldType": {
"type": [
"string",
"null"
]
},
"control": {
"type": "string",
"enum": [
"file",
"password",
"comb",
"textarea",
"text",
"checkbox",
"radio",
"select",
"listbox",
"button",
"signature",
"unsupported"
]
},
"capabilities": {
"$ref": "#/$defs/AcroForm.Inspection.fields.item.text.capabilities"
},
"readOnly": {
"type": "boolean"
},
"required": {
"type": "boolean"
},
"noExport": {
"type": "boolean"
},
"widgets": {
"$ref": "#/$defs/AcroForm.Inspection.fields.item.text.widgets"
},
"kind": {
"const": "text",
"type": "string"
},
"value": {
"type": "string"
},
"defaultValue": {
"type": "string"
},
"maxLength": {
"minimum": 1,
"type": "integer"
},
"multiline": {
"type": "boolean"
},
"password": {
"type": "boolean"
},
"fileSelect": {
"type": "boolean"
},
"spellCheck": {
"type": "boolean"
},
"scroll": {
"type": "boolean"
},
"comb": {
"type": "boolean"
},
"combSlots": {
"minItems": 1,
"type": "array",
"items": {
"additionalProperties": false,
"type": "object",
"required": [
"widthFraction",
"maxChars"
],
"properties": {
"widthFraction": {
"exclusiveMinimum": 0,
"type": "number"
},
"maxChars": {
"minimum": 1,
"type": "integer"
}
}
}
},
"lineHeight": {
"exclusiveMinimum": 0,
"type": "number"
},
"firstLineInset": {
"exclusiveMinimum": 0,
"type": "number"
},
"richText": {
"type": "boolean"
},
"alignment": {
"type": "string",
"enum": [
"left",
"center",
"right"
]
},
"text": {
"anyOf": [
{
"$ref": "#/$defs/AcroForm.Inspection.fields.item.text.widgets.item.text.resolved"
},
{
"$ref": "#/$defs/AcroForm.Inspection.fields.item.text.widgets.item.text.unresolved"
}
]
}
}
},
{
"additionalProperties": false,
"type": "object",
"required": [
"index",
"name",
"partialName",
"displayLabel",
"pdfFieldType",
"control",
"capabilities",
"readOnly",
"required",
"noExport",
"widgets",
"kind",
"checked",
"exportValue"
],
"properties": {
"index": {
"minimum": 0,
"type": "integer"
},
"name": {
"minLength": 1,
"type": "string"
},
"partialName": {
"type": "string"
},
"alternateName": {
"type": "string"
},
"mappingName": {
"type": "string"
},
"displayLabel": {
"$ref": "#/$defs/AcroForm.Inspection.fields.item.text.displayLabel"
},
"pdfFieldType": {
"type": [
"string",
"null"
]
},
"control": {
"type": "string",
"enum": [
"file",
"password",
"comb",
"textarea",
"text",
"checkbox",
"radio",
"select",
"listbox",
"button",
"signature",
"unsupported"
]
},
"capabilities": {
"$ref": "#/$defs/AcroForm.Inspection.fields.item.text.capabilities"
},
"readOnly": {
"type": "boolean"
},
"required": {
"type": "boolean"
},
"noExport": {
"type": "boolean"
},
"widgets": {
"$ref": "#/$defs/AcroForm.Inspection.fields.item.text.widgets"
},
"kind": {
"const": "checkbox",
"type": "string"
},
"checked": {
"type": "boolean"
},
"defaultChecked": {
"type": "boolean"
},
"exportValue": {
"minLength": 1,
"type": "string"
}
}
},
{
"additionalProperties": false,
"type": "object",
"required": [
"index",
"name",
"partialName",
"displayLabel",
"pdfFieldType",
"control",
"capabilities",
"readOnly",
"required",
"noExport",
"widgets",
"kind",
"selected",
"noToggleToOff",
"radiosInUnison",
"options"
],
"properties": {
"index": {
"minimum": 0,
"type": "integer"
},
"name": {
"minLength": 1,
"type": "string"
},
"partialName": {
"type": "string"
},
"alternateName": {
"type": "string"
},
"mappingName": {
"type": "string"
},
"displayLabel": {
"$ref": "#/$defs/AcroForm.Inspection.fields.item.text.displayLabel"
},
"pdfFieldType": {
"type": [
"string",
"null"
]
},
"control": {
"type": "string",
"enum": [
"file",
"password",
"comb",
"textarea",
"text",
"checkbox",
"radio",
"select",
"listbox",
"button",
"signature",
"unsupported"
]
},
"capabilities": {
"$ref": "#/$defs/AcroForm.Inspection.fields.item.text.capabilities"
},
"readOnly": {
"type": "boolean"
},
"required": {
"type": "boolean"
},
"noExport": {
"type": "boolean"
},
"widgets": {
"$ref": "#/$defs/AcroForm.Inspection.fields.item.text.widgets"
},
"kind": {
"const": "radio",
"type": "string"
},
"selected": {
"type": [
"string",
"null"
]
},
"defaultSelected": {
"type": [
"string",
"null"
]
},
"noToggleToOff": {
"type": "boolean"
},
"radiosInUnison": {
"type": "boolean"
},
"options": {
"type": "array",
"items": {
"additionalProperties": false,
"type": "object",
"required": [
"index",
"exportValue",
"widgetIndex"
],
"properties": {
"index": {
"minimum": 0,
"type": "integer"
},
"exportValue": {
"type": "string"
},
"widgetIndex": {
"minimum": 0,
"type": "integer"
}
}
}
}
}
},
{
"additionalProperties": false,
"type": "object",
"required": [
"index",
"name",
"partialName",
"displayLabel",
"pdfFieldType",
"control",
"capabilities",
"readOnly",
"required",
"noExport",
"widgets",
"kind",
"choiceType",
"editable",
"multiple",
"value",
"options",
"selectedIndices",
"sort",
"spellCheck",
"commitOnSelectionChange",
"alignment",
"text"
],
"properties": {
"index": {
"minimum": 0,
"type": "integer"
},
"name": {
"minLength": 1,
"type": "string"
},
"partialName": {
"type": "string"
},
"alternateName": {
"type": "string"
},
"mappingName": {
"type": "string"
},
"displayLabel": {
"$ref": "#/$defs/AcroForm.Inspection.fields.item.text.displayLabel"
},
"pdfFieldType": {
"type": [
"string",
"null"
]
},
"control": {
"type": "string",
"enum": [
"file",
"password",
"comb",
"textarea",
"text",
"checkbox",
"radio",
"select",
"listbox",
"button",
"signature",
"unsupported"
]
},
"capabilities": {
"$ref": "#/$defs/AcroForm.Inspection.fields.item.text.capabilities"
},
"readOnly": {
"type": "boolean"
},
"required": {
"type": "boolean"
},
"noExport": {
"type": "boolean"
},
"widgets": {
"$ref": "#/$defs/AcroForm.Inspection.fields.item.text.widgets"
},
"kind": {
"const": "choice",
"type": "string"
},
"choiceType": {
"type": "string",
"enum": [
"list",
"combo"
]
},
"editable": {
"type": "boolean"
},
"multiple": {
"type": "boolean"
},
"value": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
},
{
"$ref": "#/$defs/Problem.validation_failed.errors.item.allowedKeys"
}
]
},
"defaultValue": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
},
{
"$ref": "#/$defs/Problem.validation_failed.errors.item.allowedKeys"
}
]
},
"options": {
"type": "array",
"items": {
"additionalProperties": false,
"type": "object",
"required": [
"index",
"exportValue"
],
"properties": {
"index": {
"minimum": 0,
"type": "integer"
},
"exportValue": {
"type": "string"
},
"displayValue": {
"type": "string"
}
}
}
},
"selectedIndices": {
"type": "array",
"items": {
"minimum": 0,
"type": "integer"
}
},
"sort": {
"type": "boolean"
},
"spellCheck": {
"type": "boolean"
},
"commitOnSelectionChange": {
"type": "boolean"
},
"topIndex": {
"minimum": 0,
"type": "integer"
},
"alignment": {
"type": "string",
"enum": [
"left",
"center",
"right"
]
},
"text": {
"anyOf": [
{
"$ref": "#/$defs/AcroForm.Inspection.fields.item.text.widgets.item.text.resolved"
},
{
"$ref": "#/$defs/AcroForm.Inspection.fields.item.text.widgets.item.text.unresolved"
}
]
}
}
},
{
"additionalProperties": false,
"type": "object",
"required": [
"index",
"name",
"partialName",
"displayLabel",
"pdfFieldType",
"control",
"capabilities",
"readOnly",
"required",
"noExport",
"widgets",
"kind"
],
"properties": {
"index": {
"minimum": 0,
"type": "integer"
},
"name": {
"minLength": 1,
"type": "string"
},
"partialName": {
"type": "string"
},
"alternateName": {
"type": "string"
},
"mappingName": {
"type": "string"
},
"displayLabel": {
"$ref": "#/$defs/AcroForm.Inspection.fields.item.text.displayLabel"
},
"pdfFieldType": {
"type": [
"string",
"null"
]
},
"control": {
"type": "string",
"enum": [
"file",
"password",
"comb",
"textarea",
"text",
"checkbox",
"radio",
"select",
"listbox",
"button",
"signature",
"unsupported"
]
},
"capabilities": {
"$ref": "#/$defs/AcroForm.Inspection.fields.item.text.capabilities"
},
"readOnly": {
"type": "boolean"
},
"required": {
"type": "boolean"
},
"noExport": {
"type": "boolean"
},
"widgets": {
"$ref": "#/$defs/AcroForm.Inspection.fields.item.text.widgets"
},
"kind": {
"const": "pushbutton",
"type": "string"
}
}
},
{
"additionalProperties": false,
"type": "object",
"required": [
"index",
"name",
"partialName",
"displayLabel",
"pdfFieldType",
"control",
"capabilities",
"readOnly",
"required",
"noExport",
"widgets",
"kind",
"state"
],
"properties": {
"index": {
"minimum": 0,
"type": "integer"
},
"name": {
"minLength": 1,
"type": "string"
},
"partialName": {
"type": "string"
},
"alternateName": {
"type": "string"
},
"mappingName": {
"type": "string"
},
"displayLabel": {
"$ref": "#/$defs/AcroForm.Inspection.fields.item.text.displayLabel"
},
"pdfFieldType": {
"type": [
"string",
"null"
]
},
"control": {
"type": "string",
"enum": [
"file",
"password",
"comb",
"textarea",
"text",
"checkbox",
"radio",
"select",
"listbox",
"button",
"signature",
"unsupported"
]
},
"capabilities": {
"$ref": "#/$defs/AcroForm.Inspection.fields.item.text.capabilities"
},
"readOnly": {
"type": "boolean"
},
"required": {
"type": "boolean"
},
"noExport": {
"type": "boolean"
},
"widgets": {
"$ref": "#/$defs/AcroForm.Inspection.fields.item.text.widgets"
},
"kind": {
"const": "signature",
"type": "string"
},
"state": {
"type": "string",
"enum": [
"empty",
"signed"
]
}
}
},
{
"additionalProperties": false,
"type": "object",
"required": [
"index",
"name",
"partialName",
"displayLabel",
"pdfFieldType",
"control",
"capabilities",
"readOnly",
"required",
"noExport",
"widgets",
"kind",
"valuePresent",
"defaultValuePresent"
],
"properties": {
"index": {
"minimum": 0,
"type": "integer"
},
"name": {
"minLength": 1,
"type": "string"
},
"partialName": {
"type": "string"
},
"alternateName": {
"type": "string"
},
"mappingName": {
"type": "string"
},
"displayLabel": {
"$ref": "#/$defs/AcroForm.Inspection.fields.item.text.displayLabel"
},
"pdfFieldType": {
"type": [
"string",
"null"
]
},
"control": {
"type": "string",
"enum": [
"file",
"password",
"comb",
"textarea",
"text",
"checkbox",
"radio",
"select",
"listbox",
"button",
"signature",
"unsupported"
]
},
"capabilities": {
"$ref": "#/$defs/AcroForm.Inspection.fields.item.text.capabilities"
},
"readOnly": {
"type": "boolean"
},
"required": {
"type": "boolean"
},
"noExport": {
"type": "boolean"
},
"widgets": {
"$ref": "#/$defs/AcroForm.Inspection.fields.item.text.widgets"
},
"kind": {
"const": "unknown",
"type": "string"
},
"valuePresent": {
"type": "boolean"
},
"defaultValuePresent": {
"type": "boolean"
}
}
}
]
}
},
"diagnostics": {
"type": "array",
"items": {
"additionalProperties": false,
"type": "object",
"required": [
"code",
"severity",
"scope",
"message"
],
"properties": {
"code": {
"minLength": 1,
"type": "string"
},
"severity": {
"type": "string",
"enum": [
"info",
"warning"
]
},
"scope": {
"type": "string",
"enum": [
"document",
"page",
"field",
"widget"
]
},
"message": {
"minLength": 1,
"type": "string"
},
"pageIndex": {
"minimum": 0,
"type": "integer"
},
"fieldIndex": {
"minimum": 0,
"type": "integer"
},
"widgetIndex": {
"minimum": 0,
"type": "integer"
},
"fieldName": {
"minLength": 1,
"type": "string"
}
}
}
}
},
"$defs": {
"AcroForm.Inspection.fields.item.text.capabilities": {
"additionalProperties": false,
"type": "object",
"required": [
"fillByName",
"author"
],
"properties": {
"fillByName": {
"anyOf": [
{
"$ref": "#/$defs/AcroForm.Inspection.fields.item.text.capabilities.fillByName.anyOf0"
},
{
"$ref": "#/$defs/AcroForm.Inspection.fields.item.text.capabilities.fillByName.anyOf1"
}
]
},
"author": {
"anyOf": [
{
"$ref": "#/$defs/AcroForm.Inspection.fields.item.text.capabilities.fillByName.anyOf0"
},
{
"$ref": "#/$defs/AcroForm.Inspection.fields.item.text.capabilities.fillByName.anyOf1"
}
]
}
}
},
"AcroForm.Inspection.fields.item.text.capabilities.fillByName.anyOf0": {
"additionalProperties": false,
"type": "object",
"required": [
"supported"
],
"properties": {
"supported": {
"const": true,
"type": "boolean"
}
}
},
"AcroForm.Inspection.fields.item.text.capabilities.fillByName.anyOf1": {
"additionalProperties": false,
"type": "object",
"required": [
"supported",
"reasons"
],
"properties": {
"supported": {
"const": false,
"type": "boolean"
},
"reasons": {
"minItems": 1,
"type": "array",
"items": {
"type": "string",
"enum": [
"documentSigned",
"documentCertified",
"xfaPresent",
"needAppearances",
"pushbutton",
"signature",
"unknownFieldType",
"choiceEditable",
"choiceMultiSelect",
"richTextUnsupported",
"noWidgets",
"conflictingFlags",
"unsupportedAppearance",
"inconsistentFieldState"
]
}
}
}
},
"AcroForm.Inspection.fields.item.text.displayLabel": {
"additionalProperties": false,
"type": "object",
"required": [
"value",
"source"
],
"properties": {
"value": {
"type": "string"
},
"source": {
"type": "string",
"enum": [
"alternateName",
"partialName",
"fieldName"
]
}
}
},
"AcroForm.Inspection.fields.item.text.widgets": {
"type": "array",
"items": {
"additionalProperties": false,
"type": "object",
"required": [
"index",
"pageIndex",
"pageNumber",
"bounds",
"rect",
"displayBound
# --- truncated at 32 KB (51 KB total) ---
# Full source: https://artifacts.apis.io/blinkpdf-io/json-schema/blinkpdf-io-acro-form-inspection-schema.json
Work with this as data
Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for schemas
4 MCP tools reach this
find_json_schemasBrowse and filter every JSON Schema in the catalog.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/blinkpdf-io-acro-form-inspection"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.