Easy Sign API

-H "Idempotency-Key: 5f3a...-unique-per-attempt"

curl -X POST https://www.easy-sign.ca/api/agent/sign-request \
  -H "Authorization: Bearer es_live_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "recipient": {
      "email": "client@example.com",
      "name": "Jane Smith"
    },
    "document": {
      "url": "https://example.com/contract.pdf"
    },
    "fields": [
      {
        "type": "signature",
        "page": 1,
        "preset": "signature_bottom_right"
      },
      {
        "type": "date",
        "page": 1,
        "preset": "date_after_signature"
      }
    ],
    "envelope_name": "Contract Agreement"
  }'

{
  "type": "signature",
  "page": 1,
  "position": {
    "x": 60,      // X position (0-100%)
    "y": 85,      // Y position (0-100%)
    "width": 25,  // Width (1-50%)
    "height": 8   // Height (1-20%)
  }
}

{
  "success": true,
  "envelope_id": "550e8400-e29b-41d4-a716-446655440000",
  "signing_url": "https://www.easy-sign.ca/sign/550e8400...?token=abc123",
  "expires_at": "<ISO 8601 timestamp, ~7 days from request time>",
  "recipient_email": "client@example.com"
}

{
  "success": false,
  "error": {
    "code": "INVALID_EMAIL",
    "message": "Valid recipient email is required"
  }
}

curl -X POST https://www.easy-sign.ca/api/verify \
  -H "Content-Type: application/json" \
  -d '{ "transactionId": "ES-20241206-ABC12345" }'

curl -X POST https://www.easy-sign.ca/api/verify \
  -F "file=@signed-document.pdf" \
  -F "transactionId=ES-20241206-ABC12345"

{
  "verified": true,
  "transactionId": "ES-20241206-ABC12345",
  "status": "valid",
  "verificationType": "full",
  "hashComparison": "match",
  "message": "Document verified successfully. File integrity confirmed - no modifications detected.",
  "details": {
    "envelopeName": "Contract Agreement",
    "status": "completed",
    "createdAt": "2024-12-06T10:00:00Z",
    "completedAt": "2024-12-06T11:30:00Z",
    "recipientCount": 1,
    "signedCount": 1,
    "documentCount": 1
  }
}

{
  "verified": true,
  "transactionId": "ES-20241206-ABC12345",
  "status": "valid",
  "verificationType": "transaction_only",
  "hashComparison": "unrecognized",
  "message": "Transaction record found, but the uploaded file is not one of the 1 document(s) we hold a hash for on this transaction, so its integrity can be neither confirmed nor denied. This is expected for the audit certificate, for a re-saved, printed or scanned copy, and for documents signed before hashes were recorded. A hash match is the only positive confirmation we can give: a file we hold no hash for and a file that was altered are indistinguishable to us. The transaction details below come from our records, not from the file you provided.",
  "details": {
    "envelopeName": "Contract Agreement",
    "status": "completed",
    "createdAt": "2024-12-06T10:00:00Z",
    "completedAt": "2024-12-06T11:30:00Z",
    "recipientCount": 1,
    "signedCount": 1,
    "documentCount": 1
  }
}

{
  "name": "Easy Sign Document Verification API",
  "version": "1.0",
  "description": "Verify the authenticity of documents signed via Easy Sign",
  "usage": {
    "method": "POST",
    "contentType": "application/json or multipart/form-data",
    "parameters": {
      "transactionId": "The Transaction ID found on the document (format: ES-YYYYMMDD-XXXXXXXX)",
      "file": "Optional: Upload the signed PDF file for verification"
    }
  },
  "legal": {
    "notice": "Documents signed via Easy Sign are legally binding under Canadian provincial e-commerce legislation (e.g., Ontario Electronic Commerce Act, 2000), as well as ESIGN/UETA (US) and eIDAS (EU).",
    "auditTrail": "Complete audit trails are maintained for all signed documents."
  }
}

---
name: send-signature-request
description: Send a document for electronic signature via Easy Sign API
---

# Send Signature Request

Use this skill when the user wants to send a PDF document for electronic signature.

## Prerequisites
- Easy Sign API key stored in $EASY_SIGN_API_KEY
- PDF document (URL or local file path)

## Usage
Call the Easy Sign API to send a signature request:

```bash
curl -X POST https://www.easy-sign.ca/api/agent/sign-request \
  -H "Authorization: Bearer $EASY_SIGN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "recipient": { "email": "RECIPIENT_EMAIL", "name": "RECIPIENT_NAME" },
    "document": { "url": "DOCUMENT_URL" },
    "fields": [
      { "type": "signature", "page": 1, "preset": "signature_bottom_right" },
      { "type": "date", "page": 1, "preset": "date_after_signature" }
    ],
    "envelope_name": "Document Name"
  }'
```

## Response Handling
On success, return the `signing_url` to the user.
The recipient will receive an email notification.
Link expires in 7 days.

{
  "name": "easy_sign_send_signature_request",
  "description": "Send a PDF document for electronic signature. The recipient receives an email with a signing link.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "recipient": {
        "type": "object",
        "properties": {
          "email": { "type": "string", "format": "email" },
          "name":  { "type": "string" }
        },
        "required": ["email"]
      },
      "document": {
        "type": "object",
        "description": "Provide either url (max 20MB) or base64 (max 3MB), up to 15 pages",
        "properties": {
          "url":       { "type": "string", "format": "uri" },
          "base64":    { "type": "string" },
          "file_name": { "type": "string" }
        }
      },
      "fields": {
        "type": "array",
        "minItems": 1,
        "description": "Signature fields. At least one is required. Each field must have either a preset or a position.",
        "items": {
          "type": "object",
          "properties": {
            "type":   { "type": "string", "enum": ["signature", "signature_date", "date", "signed_datetime"] },
            "page":   { "type": "integer", "minimum": 1 },
            "preset": {
              "type": "string",
              "enum": [
                "signature_bottom_right",
                "signature_bottom_left",
                "signature_bottom_center",
                "signature_footer",
                "date_after_signature"
              ]
            },
            "position": {
              "type": "object",
              "description": "Custom placement as percent of page. Use instead of preset.",
              "properties": {
                "x":      { "type": "number", "minimum": 0, "maximum": 100 },
                "y":      { "type": "number", "minimum": 0, "maximum": 100 },
                "width":  { "type": "number", "minimum": 1, "maximum": 50 },
                "height": { "type": "number", "minimum": 1, "maximum": 20 }
              },
              "required": ["x", "y", "width", "height"]
            },
            "required": { "type": "boolean", "description": "Whether the field is mandatory (default true)" }
          },
          "required": ["type", "page"],
          "anyOf": [
            { "required": ["preset"] },
            { "required": ["position"] }
          ]
        }
      },
      "envelope_name": { "type": "string", "description": "Custom envelope name (optional)" },
      "sender_timezone": { "type": "string", "description": "IANA timezone name for the timestamp stamped next to the signature, e.g. America/Toronto (optional, defaults to UTC). Invalid values fall back to UTC; fresh responses echo the zone actually applied (replayed idempotent responses return the originally cached body)." }
    },
    "required": ["recipient", "document", "fields"]
  }
}

# Add to your shell profile (~/.bashrc, ~/.zshrc, etc.)
export EASY_SIGN_API_KEY="es_live_your_api_key_here"