‘use client’;

title: Digital Signature API description: Legally binding digital signatures for enterprise applications

Digital Signature API

Secure, legally binding digital signature services compliant with eIDAS, ESIGN, and UETA regulations

Last updated: October 15, 2025

v6.2

View on GitHub Download Postman Collection

Base URL:

https://api.mid.io/v6

Authentication:

OAuth 2.0 with JWT tokens or API Key in Authorization header

POST

/signature/documents

Create Signature Request

Upload a document and create a signature request for one or more signers.

No parameters required.

Headers

Name	Required	Description
`Authorization`	Yes	Bearer {accessToken}
`Content-Type`	Yes	multipart/form-data

POST

/signature/documents

Headers

Query Parameters

Request Body

{
  "title": "Employment Contract",
  "description": "Contract for new employee onboarding",
  "documentType": "contract",
  "expiresIn": 604800,
  "signers": [
    {
      "email": "employee@example.com",
      "name": "John Employee",
      "role": "employee",
      "verificationMethod": "email_otp",
      "signatureFields": [
        {
          "page": 4,
          "x": 100,
          "y": 500,
          "width": 200,
          "height": 50
        }
      ]
    },
    {
      "email": "manager@company.com",
      "name": "Jane Manager",
      "role": "manager",
      "verificationMethod": "mid_auth",
      "signatureFields": [
        {
          "page": 4,
          "x": 400,
          "y": 500,
          "width": 200,
          "height": 50
        }
      ]
    }
  ],
  "notificationSettings": {
    "sendEmailNotifications": true,
    "reminderFrequency": 86400
  },
  "callbackUrl": "https://your-app.com/webhooks/signature",
  "metadata": {
    "department": "HR",
    "employeeId": "EMP123"
  }
}

GET

/signature/documents/{signatureRequestId}

Get Signature Request Status

Retrieve the current status of a signature request.

Name	Type	Required	Description
`signatureRequestId`	`string`	Yes	The ID of the signature request

Headers

Name	Required	Description
`Authorization`	Yes	Bearer {accessToken}

GET

/signature/documents/{signatureRequestId}

Headers

Query Parameters

GET

/signature/documents/{signatureRequestId}/certificate

Download Signature Certificate

Download a certificate of completion that contains the audit trail and verification details.

Name	Type	Required	Description
`signatureRequestId`	`string`	Yes	The ID of the signature request

Headers

Name	Required	Description
`Authorization`	Yes	Bearer {accessToken}
`Accept`	No	application/pdf (default) or application/json

GET

/signature/documents/{signatureRequestId}/certificate