API Reference

Digital Signatures

Create legally-binding electronic signatures with biometric authentication and full audit trails.

Create Signature Request

POST
/v1/signature/documents

Create a new document signature request

Request Body

ParameterTypeRequiredDescription
documentstringYesBase64-encoded PDF document
signersarrayYesList of signer objects with email and name
callbackUrlstringNoURL to receive completion webhook
expiresInnumberNoExpiration time in hours (default: 72)
requireBiometricbooleanNoRequire biometric auth to sign (default: true)
Create signature request
curl -X POST 'https://api.mobid.io/v1/signature/documents' \
  -H 'Content-Type: application/json' \
  -H 'X-Mobid-Key: qk_your_api_key' \
  -d '{
    "document": "JVBERi0xLjQK...",
    "signers": [
      {"email": "signer@example.com", "name": "Jane Smith"}
    ],
    "callbackUrl": "https://yourapp.com/webhook/signed",
    "requireBiometric": true
  }'
Response
{
  "code": 200,
  "message": "Signature request created",
  "data": {
    "signatureRequestId": "sig_abc123",
    "status": "pending",
    "signers": [
      {
        "email": "signer@example.com",
        "name": "Jane Smith",
        "status": "awaiting_signature",
        "signUrl": "https://sign.mobid.io/sig_abc123"
      }
    ],
    "expiresAt": "2025-01-18T12:00:00Z"
  }
}

Get Signature Status

GET
/v1/signature/documents/:signatureRequestId

Check the status of a signature request

Response
{
  "code": 200,
  "data": {
    "signatureRequestId": "sig_abc123",
    "status": "completed",
    "completedAt": "2025-01-16T14:30:00Z",
    "signers": [
      {
        "email": "signer@example.com",
        "status": "signed",
        "signedAt": "2025-01-16T14:30:00Z",
        "ipAddress": "203.0.113.42",
        "biometricVerified": true
      }
    ]
  }
}

Download Signature Certificate

GET
/v1/signature/documents/:signatureRequestId/certificate

Download the signed document with embedded certificate

Returns the signed PDF document with an embedded digital certificate and audit trail.

Download signed document
curl -X GET 'https://api.mobid.io/v1/signature/documents/sig_abc123/certificate' \
  -H 'X-Mobid-Key: qk_your_api_key' \
  -o signed_document.pdf
✓

Legal Validity

MID digital signatures comply with eIDAS (EU), ESIGN Act (US), and UETA standards. Each signed document includes a verifiable audit trail with timestamps, IP addresses, and biometric verification status.