API Overview

The VisiSign API is a REST API that uses JSON for request and response bodies. All endpoints require authentication via API key.

Base URL

https://api.visisign.app/v1

Authentication

Include your API key as a Bearer token in the Authorization header:

Authorization: Bearer vsk_your_key_here

See Authentication for details on key management.

Content types

• JSON requests: Set Content-Type: application/json
• File uploads: Use multipart/form-data
• Responses: Always application/json

ID prefixes

Resources use prefixed IDs for clarity:

Prefix	Resource
sr_	Signature request
sig_	Signer
tmpl_	Template

Pagination

List endpoints return paginated results:

{
  "signature_requests": [...],
  "pagination": {
    "page": 1,
    "per_page": 20,
    "total_pages": 5,
    "total_count": 100
  }
}

Parameter	Type	Default	Max	Description
page	integer	1	—	Page number
per_page	integer	20	100	Results per page

Timestamps

All timestamps are ISO 8601 strings in UTC:

2026-03-04T12:00:00Z

Rate limits

The API is rate-limited per API key. If you exceed the limit, you’ll receive a 429 Too Many Requests response. Back off and retry after a short delay.

Errors

All error responses follow a consistent format:

{
  "error": {
    "type": "not_found",
    "message": "Signature request not found."
  }
}

See Errors for the full list of error types.