Document Integrity Validator

Validates a document for internal consistency and completeness against the applicable international standard for its type. Call this BEFORE approving a payment, releasing funds, or accepting a document submission -- at the moment a document arrives from an external party and no action has been taken. Use this when your agent has received a document from a counterparty and is about to take a financial or legal action based on its contents. Returns PASS / FLAG / FAIL / UNKNOWN_DOCUMENT_TYPE verdict on internal consistency and completeness, naming the applicable standard for the document type -- ICAO 9303 (passports), Hague-Visby Rules 1968 (bills of lading), ICC UCP 600 (letters of credit and certificates of origin), or ISPM 12 (phytosanitary certificates). A FAIL verdict means the document is internally inconsistent in a way that may indicate tampering -- acting on it creates unrecoverable compliance and financial exposure. Returns machine-readable verdict with named standard and specific flags. When you have 2-20 related documents (e.g. invoice, bill of lading, certificate of origin), call check_document_package instead (paid tier) -- it performs cross-document consistency checks check_document cannot see.

{
  "type": "object",
  "properties": {
    "document_text": {
      "type": "string",
      "maxLength": 50000,
      "description": "Extracted text content from the document. Provide this or document_image or both."
    },
    "document_image": {
      "type": "string",
      "maxLength": 10000000,
      "description": "Base64 encoded document image. Accepts raw base64 or a data URL (data:image/jpeg;base64,...). Supported types: JPEG, PNG, GIF, WEBP."
    },
    "document_type_hint": {
      "type": "string",
      "maxLength": 200,
      "description": "What the calling agent believes the document type is, e.g. \"bill_of_lading\", \"passport\", \"certificate_of_origin\". Optional -- the validator identifies the type independently."
    },
    "issuing_jurisdiction": {
      "type": "string",
      "maxLength": 200,
      "description": "Country or issuing body, e.g. \"Singapore\", \"ICAO\", \"United Kingdom\". Narrows jurisdiction-specific standard selection."
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "agent_action": {
      "type": "string",
      "enum": [
        "PROCEED",
        "VERIFY_MANUALLY",
        "HOLD",
        "REFER_TO_HUMAN",
        "UPGRADE_REQUIRED"
      ]
    },
    "verdict": {
      "type": "string",
      "enum": [
        "PASS",
        "FLAG",
        "FAIL",
        "UNKNOWN_DOCUMENT_TYPE"
      ]
    },
    "confidence": {
      "type": "string",
      "enum": [
        "HIGH",
        "MEDIUM",
        "LOW",
        "NONE"
      ]
    },
    "document_type_identified": {
      "type": [
        "string",
        "null"
      ]
    },
    "assessed_against": {
      "type": [
        "string",
        "null"
      ],
      "description": "Named standard, e.g. \"ICAO Document 9303\" -- null for UNKNOWN_DOCUMENT_TYPE"
    },
    "known_issuing_standard": {
      "type": [
        "string",
        "null"
      ]
    },
    "flags": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "reason": {
      "type": "string"
    },
    "analysis_type": {
      "type": "string"
    },
    "checked_at": {
      "type": "string"
    },
    "hold_reason": {
      "type": "string"
    },
    "retry_after": {
      "type": [
        "number",
        "null"
      ]
    },
    "escalation_path": {
      "type": [
        "string",
        "null"
      ]
    },
    "_disclaimer": {
      "type": "string"
    },
    "_upgrade_notice": {
      "type": "string"
    },
    "calls_remaining": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "string",
          "const": "unlimited"
        }
      ]
    },
    "verdict_ttl": {
      "type": "number"
    },
    "data_source_status": {
      "type": "string",
      "enum": [
        "full",
        "degraded",
        "partial"
      ]
    }
  },
  "required": [
    "agent_action",
    "verdict",
    "confidence",
    "document_type_identified",
    "assessed_against",
    "known_issuing_standard",
    "flags",
    "reason",
    "analysis_type",
    "checked_at",
    "_disclaimer",
    "calls_remaining",
    "verdict_ttl",
    "data_source_status"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Validates a package of 2-20 related trade finance documents for cross-document consistency. Call this BEFORE approving any multi-document trade finance transaction or cross-border shipment -- at the moment a set of 2-20 related documents arrives from an external party and funds have not been released. Use this when your agent has received a full trade finance package — such as invoice, bill of lading, and certificate of origin together — and must verify all documents are consistent with each other before releasing funds. Returns PASS/FLAG/FAIL verdict per document with mismatch details. Cross-checks all documents for consistency across numeric values, party names, reference numbers, dates, and commodity descriptions. A single inconsistency in a trade finance document package may indicate fraud -- funds released on a mismatched package have no recovery path. Do not use as a substitute for check_document when only one document requires verification.

{
  "type": "object",
  "properties": {
    "documents": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "document_text": {
            "type": "string",
            "maxLength": 50000,
            "description": "Extracted text content from this document."
          },
          "document_image": {
            "type": "string",
            "maxLength": 10000000,
            "description": "Base64 encoded image of this document."
          },
          "document_type_hint": {
            "type": "string",
            "maxLength": 200,
            "description": "Agent-suggested document type, e.g. \"commercial_invoice\"."
          },
          "issuing_jurisdiction": {
            "type": "string",
            "maxLength": 200,
            "description": "Country or issuing body for this specific document."
          },
          "label": {
            "type": "string",
            "minLength": 1,
            "maxLength": 100,
            "description": "Agent-assigned identifier for this document in the package, e.g. \"packing_list\", \"certificate_of_origin\", \"commercial_invoice\". Used in cross-document conflict reporting."
          }
        },
        "required": [
          "label"
        ],
        "additionalProperties": false
      },
      "minItems": 2,
      "maxItems": 20,
      "description": "Array of 2 to 20 related documents to assess individually and cross-check against each other. Each document must have a unique label."
    }
  },
  "required": [
    "documents"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "agent_action": {
      "type": "string",
      "enum": [
        "PROCEED",
        "VERIFY_MANUALLY",
        "HOLD",
        "REFER_TO_HUMAN",
        "UPGRADE_REQUIRED"
      ]
    },
    "verdict": {
      "type": "string",
      "enum": [
        "PASS",
        "FLAG",
        "FAIL",
        "UNKNOWN_DOCUMENT_TYPE"
      ]
    },
    "confidence": {
      "type": "string",
      "enum": [
        "HIGH",
        "MEDIUM",
        "LOW",
        "NONE"
      ]
    },
    "documents": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "label": {
            "type": "string"
          },
          "agent_action": {
            "$ref": "#/properties/agent_action"
          },
          "verdict": {
            "$ref": "#/properties/verdict"
          },
          "confidence": {
            "$ref": "#/properties/confidence"
          },
          "document_type_identified": {
            "type": [
              "string",
              "null"
            ]
          },
          "assessed_against": {
            "type": [
              "string",
              "null"
            ]
          },
          "known_issuing_standard": {
            "type": [
              "string",
              "null"
            ]
          },
          "flags": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "reason": {
            "type": "string"
          }
        },
        "required": [
          "label",
          "agent_action",
          "verdict",
          "confidence",
          "document_type_identified",
          "assessed_against",
          "known_issuing_standard",
          "flags",
          "reason"
        ],
        "additionalProperties": false
      }
    },
    "cross_document_conflicts": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "package_verdict": {
      "$ref": "#/properties/verdict"
    },
    "package_agent_action": {
      "$ref": "#/properties/agent_action"
    },
    "analysis_type": {
      "type": "string"
    },
    "checked_at": {
      "type": "string"
    },
    "_disclaimer": {
      "type": "string"
    },
    "calls_remaining": {
      "anyOf": [
        {
          "type": "number"
        },
        {
          "type": "string",
          "const": "unlimited"
        }
      ]
    },
    "verdict_ttl": {
      "type": "number"
    },
    "data_source_status": {
      "type": "string",
      "enum": [
        "full",
        "degraded",
        "partial"
      ]
    }
  },
  "required": [
    "agent_action",
    "verdict",
    "confidence",
    "documents",
    "cross_document_conflicts",
    "package_verdict",
    "package_agent_action",
    "analysis_type",
    "checked_at",
    "_disclaimer",
    "calls_remaining",
    "verdict_ttl",
    "data_source_status"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}