API Documentation

Integrate Zdottedline into your workflows with our REST + tRPC API.

API access available on Professional and Enterprise plans.

Authentication

All authenticated endpoints require a Bearer token in the Authorization header.

curl -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  https://zdottedline.com/api/trpc/documents.list

Access tokens expire in 15 minutes. Use the refresh token endpoint to obtain new ones.

Base URL

https://zdottedline.com/api

Endpoints

POST/api/trpc/auth.registerCreate a new accountPUBLIC

POST/api/trpc/auth.loginAuthenticate and receive JWT tokensPUBLIC

GET/api/trpc/auth.meGet current authenticated user profileAUTH

POST/api/trpc/documents.uploadUpload a document (base64 encoded)AUTH

GET/api/trpc/documents.listList documents with pagination and filteringAUTH

GET/api/trpc/documents.getGet a single document with signers and fieldsAUTH

POST/api/trpc/documents.addSignerAdd a signer to a documentAUTH

POST/api/trpc/documents.addFieldPlace a signature field on a document pageAUTH

POST/api/trpc/documents.sendSend a document for signingAUTH

POST/api/trpc/signing.submitFieldsSubmit signature (public, token-based)PUBLIC

GET/api/trpc/documents.getForSigningGet document for signing (public, token-based)PUBLIC

GET/api/trpc/billing.statusGet subscription statusAUTH

GET/api/trpc/team.listList team membersAUTH

POST/api/trpc/team.inviteInvite a team memberAUTH

GET/api/healthHealth check endpointPUBLIC

Example: Upload and Send a Document

1. Login

curl -X POST https://zdottedline.com/api/trpc/auth.login \
  -H "Content-Type: application/json" \
  -d '{"json":{"email":"you@company.com","password":"yourpassword"}}'

2. Upload a document

curl -X POST https://zdottedline.com/api/trpc/documents.upload \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"json":{"title":"Contract","fileBase64":"...","fileName":"contract.pdf","mimeType":"application/pdf"}}'

3. Add a signer and send

# Add signer
curl -X POST https://zdottedline.com/api/trpc/documents.addSigner \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -d '{"json":{"documentId":"DOC_ID","email":"signer@example.com","name":"Jane Smith","signOrder":1}}'

# Send for signing
curl -X POST https://zdottedline.com/api/trpc/documents.send \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  -d '{"json":{"documentId":"DOC_ID"}}'

Webhooks

Webhook notifications for document events are coming soon. Subscribe to events like document.completed, signer.signed, and signer.declined.

Rate Limits

Authentication endpoints5 requests per 15 minutes

General API100 requests per 15 minutes

Document upload20 requests per 15 minutes

Need help with the API?

Contact our developer support team.

support@zdottedline.com