letssign.now
Start now

API overview

Base URL, authentication, versioning policy, and the full map of v1 resources.

The letssign.now REST API is a single, versioned surface. Everything you integrate against lives under /api/v1/.

Base URL & auth

https://www.letssign.now/api/v1
Authorization: Bearer lsk_live_…

All requests authenticate with a workspace API key (Authorization: Bearer). Mint and manage keys in Settings → API. Requests are rate-limited per key (a 429 carries a Retry-After).

Versioning

  • /api/v1 is stable. We only make additive changes within it (new optional fields, new endpoints) — never breaking ones.
  • A breaking change would ship under /api/v2; v1 keeps working.
  • Always pin to the version in the path.

Resources

ResourceEndpointsWhat it does
Signing requestsPOST /signing-requests, GET/DELETE /signing-requests/{id}, /remind, /withdrawSend a PDF (bytes or file_url) for signature with explicit/anchor/auto/manual placement.
DocumentsPOST /documents, GET /documents/{id}, /signed, /audit-trailCreate from a file_url, fetch the signed PDF + audit trail.
TemplatesGET /templates, POST /templates/{id}/instantiateList templates and instantiate a locked one with field_values (placeholder filling).
FieldsGET /fieldsDiscover the workspace field & API-object registry — keys, types, enum options, examples, max length — so you know what field_values to send.
Embedded sessionsPOST /embedded/sessions, GET /embedded/sessions/{id}White-label / in-app signing sessions.

Note: template instantiation also responds at the legacy path /api/templates/{id}/instantiate. That alias is kept for backwards compatibility — new integrations should use /api/v1/templates/{id}/instantiate.

Two ways to start a signature

  1. Direct — POST /api/v1/signing-requests with a one-off PDF (file or file_url) and explicit field positions. Best for ad-hoc documents.
  2. Template — POST /api/v1/templates/{id}/instantiate against a locked template, supplying field_values. Best for the same contract sent many times. Discover the fields to send via GET /api/v1/fields.

On this page

Base URL & authVersioningResourcesTwo ways to start a signature