SignBolt Python SDK

from signbolt import SignBolt
import os

# Load from environment
client = SignBolt(api_key=os.environ['SIGNBOLT_API_KEY'])

# With additional options
client = SignBolt(
    api_key=os.environ['SIGNBOLT_API_KEY'],
    base_url='https://signbolt.au/api/v1',  # default
    timeout=30.0,  # seconds
    max_retries=3,
)

# Async client
from signbolt import AsyncSignBolt

async_client = AsyncSignBolt(api_key=os.environ['SIGNBOLT_API_KEY'])

# Flask example
from flask import Flask, request, jsonify
from signbolt import SignBolt
import os
import json

app = Flask(__name__)
client = SignBolt(api_key=os.environ['SIGNBOLT_API_KEY'])
webhook_secret = os.environ['SIGNBOLT_WEBHOOK_SECRET']

@app.route('/webhooks/signbolt', methods=['POST'])
def signbolt_webhook():
    signature = request.headers.get('X-SignBolt-Signature')
    body = request.get_data()

    # Verify signature
    if not client.webhooks.verify(body=body, signature=signature, secret=webhook_secret):
        return jsonify({'error': 'Invalid signature'}), 401

    event = json.loads(body)
    event_type = event['type']

    if event_type == 'document.signed':
        document_id = event['data']['documentId']
        signer = event['data']['signerEmail']
        print(f'Document {document_id} signed by {signer}')
        # Update database, send notification

    elif event_type == 'document.completed':
        document_id = event['data']['documentId']
        print(f'Document {document_id} fully signed')
        # Download final PDF

    elif event_type == 'document.declined':
        print(f'Signer declined: {event["data"]["signerEmail"]}')

    elif event_type == 'document.expired':
        print(f'Document {event["data"]["documentId"]} expired')

    return jsonify({'received': True}), 200


# FastAPI example
from fastapi import FastAPI, Request, HTTPException
from signbolt import AsyncSignBolt

app = FastAPI()
async_client = AsyncSignBolt(api_key=os.environ['SIGNBOLT_API_KEY'])

@app.post('/webhooks/signbolt')
async def signbolt_webhook(request: Request):
    signature = request.headers.get('x-signbolt-signature')
    body = await request.body()

    if not async_client.webhooks.verify(body=body, signature=signature, secret=webhook_secret):
        raise HTTPException(status_code=401, detail='Invalid signature')

    event = json.loads(body)

    if event['type'] == 'document.completed':
        # Fetch the signed PDF
        signed_doc = await async_client.documents.get(event['data']['documentId'])
        # ... process the signed document

    return {'received': True}

from signbolt import SignBolt
from datetime import datetime, timezone
import os

client = SignBolt(api_key=os.environ['SIGNBOLT_API_KEY'])

# Recent completed documents
def get_recent_signed():
    page1 = client.documents.list(
        status='completed',
        limit=50,
    )

    print(f'Got {len(page1.data)} documents')

    # Paginate
    if page1.next_cursor:
        page2 = client.documents.list(
            status='completed',
            limit=50,
            cursor=page1.next_cursor,
        )
        print(f'Got another {len(page2.data)} documents')

# Filter by date range
def get_docs_for_march():
    docs = client.documents.list(
        created_after=datetime(2026, 3, 1, tzinfo=timezone.utc),
        created_before=datetime(2026, 4, 1, tzinfo=timezone.utc),
        limit=100,
    )

    for doc in docs.data:
        print(f'{doc.filename} — signed by {doc.signer_email} on {doc.signed_at}')

# Iterate all documents (handles pagination automatically)
def iterate_all():
    for doc in client.documents.list_all(status='completed'):
        print(doc.filename)