API Docs · Alba 365 · Alba 365 PDF Editor

Quickstart

# Sign in to get your API key at /settings/api
curl -X POST https://api.alba365.com/v1/documents \
  -H "Authorization: Bearer alba_sk_..." \
  -H "Content-Type: application/pdf" \
  --data-binary @contract.pdf

# Convert a PDF to Word
curl -X POST https://api.alba365.com/v1/documents/doc_abc/convert \
  -H "Authorization: Bearer alba_sk_..." \
  -d '{"format": "docx"}'

# Send for signature
curl -X POST https://api.alba365.com/v1/documents/doc_abc/sign \
  -H "Authorization: Bearer alba_sk_..." \
  -d '{
    "signers": [{"email": "alice@example.com", "name": "Alice"}],
    "fields": [{"page": 1, "x": 100, "y": 200, "type": "signature"}]
  }'

All endpoints accept and return JSON. Document uploads stream as rawapplication/pdf bytes. Errors are 4xx / 5xx with a JSON{ error: { code, message } }shape.

Endpoint reference

Full OpenAPI spec at api.alba365.com/v1/openapi.json when v1 ships out of beta.

POST/v1/documentsUpload a new PDF

GET/v1/documents/:idFetch document metadata

POST/v1/documents/:id/editApply edits programmatically

POST/v1/documents/:id/signSend for signature

POST/v1/documents/:id/convertConvert to Word, Excel, PowerPoint, JPG

POST/v1/documents/:id/ocrRun OCR on a scanned PDF

POST/v1/documents/:id/redactPattern-based or coordinate-based redaction

POST/v1/documents/:id/protectAES-256 with open + permissions passwords

POST/v1/documents/:id/mergeMerge with another document

DELETE/v1/documents/:idDelete the document and all derivatives

GET/v1/webhooksList configured webhooks

POST/v1/webhooksRegister a webhook endpoint

Webhooks

Subscribe to events and we'll POST to your endpoint when they fire. Events available:

document.created
document.opened
document.signed
document.completed
document.declined
document.deleted
ocr.completed
conversion.completed

Every webhook is signed with HMAC-SHA256. Verify with theX-Alba-Signature header.

SDKs

TypeScript / JavaScript

Beta

npm install @alba365/sdk

Python

Beta

pip install alba365

Go

Coming soon

go get github.com/alba365/sdk-go

Ruby