API Reference

Sign documents programmatically.

REST API with full e-signature capabilities. Send documents, track status, and collect signatures — all via API. $0.30 per sent envelope, with up to 10 signers included.

Authentication

All API requests require an API key. Create one in your account settings (available when FairSign launches). API keys require a payment method on file.

bash 
curl -X POST https://api.faircompany.ai/v1/sign/envelopes \
  -H "Authorization: Bearer fsk_live_abc123..." \
  -H "Content-Type: application/json"
POST /v1/sign/envelopes/:id/send $0.30/envelope

Send Envelope

Create and configure the draft for free, then send it for $0.30. The price is flat for one to ten signers; the first five envelopes are free.

Request 
{
  "name": "Series A Term Sheet",
  "document": "base64_encoded_pdf...",
  "signers": [
    {
      "email": "sarah@investor.com",
      "name": "Sarah Chen",
      "order": 1
    },
    {
      "email": "alex@startup.com",
      "name": "Alex Rivera",
      "order": 2
    }
  ],
  "fields": [
    {
      "type": "signature",
      "signer": 0,
      "page": 3,
      "x": 100,
      "y": 600,
      "width": 200,
      "height": 50
    }
  ]
}
Response — 201 Created 
{
  "id": "env_abc123",
  "status": "sent",
  "name": "Series A Term Sheet",
  "signers": [
    {
      "email": "sarah@investor.com",
      "status": "pending"
    }
  ],
  "cost": {
							"estimated": 0.30,
    "currency": "USD",
    "holdId": "hold_xyz789"
  },
  "createdAt": "2026-03-09T14:23:01Z"
}

Per-Endpoint Pricing

Every API call that costs money shows the price upfront. Free endpoints are marked as such.

POST /v1/sign/envelopes/:id/send
$0.30/envelope
GET /v1/sign/envelopes/:id
Free
GET /v1/sign/envelopes
Free
POST /v1/sign/envelopes/:id/remind
Free
GET /v1/sign/envelopes/:id/download
Free
POST /v1/sign/envelopes/:id/bulk-send
$0.30/envelope

Webhook Events

Configure webhooks to receive real-time notifications when envelopes are viewed, signed, or completed.

envelope.sent Envelope sent to signers
envelope.viewed Signer opened the document
envelope.signed Individual signer completed
envelope.completed All signatures collected
envelope.declined Signer declined to sign
envelope.expired Envelope expired (configurable)