Skip to main content

Squillify development is paused indefinitely. Read why, and discover what this experiment achieved. Read the story

MicroSkills Reference

Validate Signature Block

legal.signature_block_validate

ProductionBounded custom (Class B)Deterministicstrictfastv1.0.0
No network

Overview

You send the expected parties and the blocks you already extracted. We check coverage, duplicate party blocks, blank names and the SIGNATURE, DATE, TITLE or WITNESS flags you listed. signaturePresent is only a boolean. A successful call costs 1 execution credit.

Signature-page checklists are completeness mechanics; treating a boolean as a verified signature would be advice.

Reliability

SIGNATURE_LIMIT_EXCEEDED — trigger: more than 64 parties, 64 blocks or 8 witnesses; retryable: no; next: trim the lists.

Context footprint

Names and booleans only; no image bytes. A successful call costs 1 execution credit.

When to use it

When blocks are already extracted and you need party coverage plus your own required flags.

When you need to authenticate ink, a certificate or signatory authority.

Powered by Squillify's own closed signature-block checklist on the flags you list.

Scope

Note
Checks extracted signature blocks for party coverage and caller-selected completeness flags.

Non-goals

  • Does not authenticate a signature or certificate
  • Does not recognise handwriting
  • Does not decide signatory authority

Properties

IdempotentRetry safeStreaming supportedFile input supportedRequires external service

Capabilities

validation

Cost & billing

Flat rate per invocation

MetercallsBillable onsuccessCost per call1 credit

File handling

Accepts file_refProduces file_refMax input64 KB

How we handle your data

Sensitive input, safe output
What this means

This skill may receive sensitive content, but it does not target sensitive data and returns only a structured non-sensitive result.

Squillify guarantees
  • Runs inside Squillify
  • This skill runs inside Squillify.
  • Payloads are not sent to an external service by this skill.
  • Squillify does not permanently store submitted payloads.
  • Telemetry records metadata only, not submitted content.
  • Submitted payloads are not used for training.
  • Submitted payloads are not reviewed by humans.
  • This skill does not target sensitive data.
  • The response does not contain submitted content.
Your responsibility

Squillify does not determine whether submitted content is sensitive. Your application is responsible for deciding what data it is allowed to submit. Your application is responsible for securing the response.

Read the Microskill Data Handling Policy

Input schema

FieldTypeRequiredDescription
expectedPartiesarrayYesExpected parties with id and type, 1 through 65 entries; runtime accepts at most 64.
blocksarrayNoExtracted signature blocks, 0 through 65 entries; runtime accepts at most 64. Omit it for none.
requiredarrayNoSIGNATURE, DATE, TITLE or WITNESS flags applied to each block; omit it for coverage-only checking.

Output schema

FieldTypeRequiredDescription
validbooleanYesTrue when no ERROR diagnostic was produced.
coveragearrayYesPer-block coverage rows in request order, 0 through 64 entries.
diagnosticsarrayYesDeterministically ordered diagnostics, 0 through 500 entries, each with code, severity, message and path; empty when nothing was flagged.
assumptionsarrayYesCaller-visible mechanical assumptions for this answer, such as default weekend days or a grammar version, never a legal conclusion.
limitationsstringYesFixed notice that only supplied parameters are applied and that validity, compliance and enforceability are not determined.

API contract

POST /v1/execute
curl
curl -sS -X POST "$BASE/v1/execute" -H "Authorization: Bearer $KEY" -H 'Content-Type: application/json' -d '{"skillKey":"legal.signature_block_validate","input":{"expectedParties":[{"id":"p-buyer","type":"ORGANIZATION"}],"blocks":[{"partyId":"p-buyer","signatoryName":"Alex Rivera","signaturePresent":true}]}}'
Integrations
TypeScript SDK
import { Squillify } from "@squillify/sdk";

const sq = new Squillify({ apiKey: process.env.SQUILLIFY_API_KEY });

const { output } = await sq.execute("legal.signature_block_validate", {"blocks":[{"title":"Director","partyId":"p-buyer","witnesses":[{"name":"Sam Lee"}],"signatoryName":"Alex Rivera","capacity":"for Northwind Ltd","date":"2024-03-01","signaturePresent":true}],"required":["SIGNATURE","DATE","TITLE","WITNESS"],"expectedParties":[{"type":"ORGANIZATION","id":"p-buyer"}]});

Errors

CodeHTTPRetryableDescription
VALIDATION_ERROR400NoThe request payload failed schema validation.
UNAUTHORIZED401NoMissing or invalid API key.
SKILL_NOT_ACCESSIBLE403NoThe API key is not granted access to this skill.
SKILL_NOT_AVAILABLE_FOR_PLAN403NoThis skill is not included in your current plan.
PLAN_ELIGIBILITY_UNAVAILABLE503YesPlan eligibility could not be decided. Retry after backoff.
SKILL_NOT_FOUND404NoThe requested skill or version does not exist.
TENANT_RATE_LIMITED429YesRequest rate limit exceeded. Retry after backoff.
QUOTA_EXCEEDED429YesPlan quota exhausted. Retryable once the quota period resets.
EXECUTION_TIMEOUT504YesExecution exceeded the allowed time budget.
SIGNATURE_LIMIT_EXCEEDED429NoA size, quota, rate, or time limit was exceeded.

Other limits

LimitValue
Recommended inline bytes32 KiB

Limitations

  • Does not authenticate a signature or certificate
  • Does not recognise handwriting
  • Does not decide signatory authority
  • e-signing
  • Handwriting recognition

How to call

POST /v1/execute (requires authentication)

Request bodyjson
{
  "skillKey": "legal.signature_block_validate",
  "input": {
    "blocks": [
      {
        "title": "Director",
        "partyId": "p-buyer",
        "witnesses": [
          {
            "name": "Sam Lee"
          }
        ],
        "signatoryName": "Alex Rivera",
        "capacity": "for Northwind Ltd",
        "date": "2024-03-01",
        "signaturePresent": true
      }
    ],
    "required": [
      "SIGNATURE",
      "DATE",
      "TITLE",
      "WITNESS"
    ],
    "expectedParties": [
      {
        "type": "ORGANIZATION",
        "id": "p-buyer"
      }
    ]
  }
}

Examples

Organization block with signature, date, title and witness

Inputjson
{
  "blocks": [
    {
      "title": "Director",
      "partyId": "p-buyer",
      "witnesses": [
        {
          "name": "Sam Lee"
        }
      ],
      "signatoryName": "Alex Rivera",
      "capacity": "for Northwind Ltd",
      "date": "2024-03-01",
      "signaturePresent": true
    }
  ],
  "required": [
    "SIGNATURE",
    "DATE",
    "TITLE",
    "WITNESS"
  ],
  "expectedParties": [
    {
      "type": "ORGANIZATION",
      "id": "p-buyer"
    }
  ]
}
Expected outputjson
{
  "limitations": "Calculations use only the parameters supplied in this call. No implicit legal rule is applied, and the answer does not determine validity, compliance or enforceability.",
  "coverage": [
    {
      "partyId": "p-buyer",
      "signaturePresent": true,
      "date": "2024-03-01",
      "witnessCount": 1
    }
  ],
  "valid": true,
  "assumptions": [
    "signaturePresent is a caller boolean; no signature image or certificate is inspected.",
    "Witness, date and title requirements apply only when listed in required."
  ],
  "diagnostics": []
}
Tip
All four required flags are present, so valid is true.

Second expected party has no block

Inputjson
{
  "blocks": [
    {
      "signatoryName": "Alex Rivera",
      "signaturePresent": true,
      "partyId": "p-buyer"
    }
  ],
  "expectedParties": [
    {
      "type": "ORGANIZATION",
      "id": "p-buyer"
    },
    {
      "type": "ORGANIZATION",
      "id": "p-seller"
    }
  ]
}
Expected outputjson
{
  "limitations": "Calculations use only the parameters supplied in this call. No implicit legal rule is applied, and the answer does not determine validity, compliance or enforceability.",
  "coverage": [
    {
      "partyId": "p-buyer",
      "signaturePresent": true,
      "witnessCount": 0
    }
  ],
  "valid": false,
  "assumptions": [
    "signaturePresent is a caller boolean; no signature image or certificate is inspected.",
    "Witness, date and title requirements apply only when listed in required."
  ],
  "diagnostics": [
    {
      "code": "ORGANIZATION_CAPACITY_BLANK",
      "severity": "WARNING",
      "message": "Organization party has no capacity label on this block.",
      "path": "/blocks/0/capacity"
    },
    {
      "code": "MISSING_PARTY_BLOCK",
      "severity": "ERROR",
      "message": "An expected party has no signature block.",
      "path": "/expectedParties"
    }
  ]
}
Tip
p-seller has no block, so MISSING_PARTY_BLOCK is reported.
  • Confirm every expected party has a block
  • Require a witness name when your checklist says so

Avoid for

  • e-signing
  • Handwriting recognition

Composable with

Safety & privacy

  • Runs without calling any external service.
  • Your payloads are never stored permanently.
  • Telemetry captures metadata only — never your payload contents.
  • We never train models on your payloads.
  • No human reviews your payloads.

Tags

validationlegal