Documents

Sign multiple documents at once using a saved signature

post/api/v1/documents/bulk-sign

Request

  • Base URL: https://api.korala.ai
  • URL: https://api.korala.ai/api/v1/documents/bulk-sign
  • Auth: one of:
    • API key in header X-API-Key
    • bearer (a scheme the document does not define)

Headers

user-agentstring required

Request body

documentIdsstring[] required

Document IDs to sign (max 500)

signerEmailstring

Signer email. Exactly one of signerEmail or signerExternalId is required. When one person holds several roles on the same document and so appears as several signers with this email, the call takes the lowest signing order that has not signed or declined, so repeated calls walk the roles in order. Use signerExternalId to name one specific signer instead.

signerExternalIdstring

Signer external ID. Exactly one of signerEmail or signerExternalId is required.

autoFillDateValuestring

Value to auto-fill Date fields, as ISO YYYY-MM-DD. Defaults to today. Each field renders it through its own dateFormat, so one batch can span fields with different formats. A non-ISO value is stamped verbatim.

Example request

{
  "signerEmail": "ceo@company.com",
  "signerExternalId": "user_123",
  "autoFillDateValue": "2026-02-18",
  "documents": [
    {
      "fields": [
        {
          "signatureImageUrl": "data:image/png;base64,..."
        }
      ]
    }
  ]
}

Response

signednumber required

Number of documents successfully signed

failednumber required

Number of documents that failed

Changes

No recorded changes to this operation across all 1 revision of this API.