---
title: "Initiate eSign workflow"
method: POST
path: "/verify/esign"
tags: ["eSign"]
---

# Initiate eSign workflow

`POST /verify/esign`

Initiates an electronic signature workflow for one or more documents and signers. Requires X-API-KEY and X-Client-ID headers.

## Request body

- EsignRequest
  - `agreement_type` string, required — Type of agreement (e.g., NDA)
  - `docket_title` string, required
  - `docket_description` string
  - `final_copy_recipients` string, email — Email address to receive final copy
  - `callback_file_content` boolean — If true, the callback may include file content
  - `documents` DocumentItem[], required
    - `reference_doc_id` string, required
    - `content_type` string, required — mime / short type (e.g., pdf, docx)
    - `content` string, byte, required — Base64-encoded PDF file content. PDF payload must not exceed 10 MB.
    - `signature_sequence` 'sequential' | 'parallel'
    - `return_url` string, uri
  - `signers_info` SignersInfoItem[], required
    - `signer_ref_id` string, required
    - `signer_name` string, required
    - `signer_email` string, email, required
    - `signer_mobile` string, required
    - `signature_type` string — Type of signature (e.g., aadhaar, otp)
    - `authentication_mode` string
    - `document_to_be_signed` string, required
    - `signer_position` SignerPosition
      - `appearance` string, required — Visual placement hint (e.g., bottom-right, top-left)
    - `page_number` string
    - `sequence` string, required
    - `trigger_esign_request` boolean

## Response `200`

eSign request accepted

- EsignResponse
  - `status` string, required
  - `docket_id` string, required
  - `document_id` string, required
  - `response_time_stamp` string, date-time, required
  - `signer_info` EsignSignerInfoItem[], required
    - `signer_ref_id` string, required
    - `signer_id` string, required
    - `document_id` string, required
    - `reference_doc_id` string, required
    - `invitation_link` string, uri, required
  - `chargeable` boolean, required
  - `user_consent` boolean, required

---

[API](https://skmtc.dev/idto/apis/verification-api.md) · [All operations](https://skmtc.dev/idto/apis/verification-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/idto/verification-api/revisions/e3d57dab8db4/schema)