Skip to content
VisiSign Docs

Getting Started

VisiSign is an e-signing platform with a REST API for programmatic document signing. Use the API to send documents for signature, track their status, and receive webhook notifications when signers take action.

Create an API key

Section titled “Create an API key”
  1. Sign in to VisiSign and go to Settings > API Keys.
  2. Enter a name for your key (e.g. “production” or “ci/cd”) and click Generate Key.
  3. Copy the key immediately — it starts with vsk_ and is only shown once.

Base URL

Section titled “Base URL”

All API requests use the base URL:

https://api.visisign.app/v1

Authentication

Section titled “Authentication”

Include your API key in the Authorization header:

Terminal window
curl https://api.visisign.app/v1/signature_requests \
  -H "Authorization: Bearer vsk_your_key_here"

Send your first signature request

Section titled “Send your first signature request”

Upload a PDF and send it for signature:

Terminal window
curl -X POST https://api.visisign.app/v1/signature_requests \
  -H "Authorization: Bearer vsk_your_key_here" \
  -F "file=@contract.pdf" \
  -F 'data={
    "title": "Service Agreement",
    "signers": [
      {
        "name": "Jane Smith",
        "email": "jane@example.com"
      }
    ]
  }'

The response includes a signature_request object with the request ID and signer details:

{
  "signature_request": {
    "id": "sr_123",
    "title": "Service Agreement",
    "status": "sent",
    "signers": [
      {
        "id": "sig_456",
        "name": "Jane Smith",
        "email": "jane@example.com",
        "status": "pending"
      }
    ]
  }
}

VisiSign emails each signer a unique link to review and sign the document.

Check the status

Section titled “Check the status”

Poll the signature request to see if it’s been signed:

Terminal window
curl https://api.visisign.app/v1/signature_requests/sr_123 \
  -H "Authorization: Bearer vsk_your_key_here"

Or set up webhooks to be notified in real time.

Download the signed PDF

Section titled “Download the signed PDF”

Once all signers have signed, download the completed document:

Terminal window
curl -L https://api.visisign.app/v1/signature_requests/sr_123/files \
  -H "Authorization: Bearer vsk_your_key_here" \
  -o signed-contract.pdf

Next steps

Section titled “Next steps”