Quickstart

# Build the JSON body (jq 1.6+; --rawfile avoids command-line length limits)
base64 < agreement.pdf | tr -d '\n' > agreement.b64
jq -n --rawfile b64 agreement.b64 '{
  title: "Service Agreement",
  signingOrderType: "parallel",
  signers: [
    {signerType: "external", name: "Alice Johnson", email: "[email protected]", signOrder: 1},
    {signerType: "external", name: "Bob Smith", email: "[email protected]", signOrder: 2}
  ],
  files: [{filename: "agreement.pdf", contentType: "application/pdf", contentBase64: $b64}],
  delivery: "link",
  expiresInDays: 30
}' > send.json

curl -X POST https://api.econtract.online/api/v1/contracts/send \
  -H "Authorization: Bearer $ECONTRACT_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d @send.json

# keep the "id" of the response for the next steps
export CONTRACT_ID=8c1e2f3a-4b5c-4d6e-8f90-1a2b3c4d5e6f

import { readFile } from "node:fs/promises";
import { randomUUID } from "node:crypto";

const API = "https://api.econtract.online/api/v1";
const headers = {
  Authorization: `Bearer ${process.env.ECONTRACT_API_KEY}`,
  "Content-Type": "application/json",
};

const pdf = await readFile("agreement.pdf");
const res = await fetch(`${API}/contracts/send`, {
  method: "POST",
  headers: { ...headers, "Idempotency-Key": randomUUID() },
  body: JSON.stringify({
    title: "Service Agreement",
    signingOrderType: "parallel",
    signers: [
      { signerType: "external", name: "Alice Johnson", email: "[email protected]", signOrder: 1 },
      { signerType: "external", name: "Bob Smith", email: "[email protected]", signOrder: 2 },
    ],
    files: [{ filename: "agreement.pdf", contentType: "application/pdf", contentBase64: pdf.toString("base64") }],
    delivery: "link",
    expiresInDays: 30,
  }),
});
if (res.status !== 202) throw new Error(JSON.stringify(await res.json()));
const contract = await res.json();
console.log(contract.id, contract.code, contract.processingStatus); // ... "processing"

import base64
import os
import uuid

import requests

API = "https://api.econtract.online/api/v1"
HEADERS = {"Authorization": f"Bearer {os.environ['ECONTRACT_API_KEY']}"}

with open("agreement.pdf", "rb") as f:
    pdf_b64 = base64.b64encode(f.read()).decode()

res = requests.post(
    f"{API}/contracts/send",
    headers={**HEADERS, "Idempotency-Key": str(uuid.uuid4())},
    json={
        "title": "Service Agreement",
        "signingOrderType": "parallel",
        "signers": [
            {"signerType": "external", "name": "Alice Johnson", "email": "[email protected]", "signOrder": 1},
            {"signerType": "external", "name": "Bob Smith", "email": "[email protected]", "signOrder": 2},
        ],
        "files": [{"filename": "agreement.pdf", "contentType": "application/pdf", "contentBase64": pdf_b64}],
        "delivery": "link",
        "expiresInDays": 30,
    },
    timeout=120,
)
assert res.status_code == 202, res.json()
contract = res.json()
print(contract["id"], contract["code"], contract["processingStatus"])  # ... "processing"

curl https://api.econtract.online/api/v1/contracts/$CONTRACT_ID \
  -H "Authorization: Bearer $ECONTRACT_API_KEY"
# repeat until "processingStatus": "ready"  (status is then "in_signing")

async function waitUntilReady(id) {
  for (;;) {
    const c = await fetch(`${API}/contracts/${id}`, { headers }).then((r) => r.json());
    if (c.processingStatus === "ready") return c;
    if (c.processingStatus === "failed") throw new Error(c.processingError);
    await new Promise((r) => setTimeout(r, 3000));
  }
}
await waitUntilReady(contract.id);

import time

def wait_until_ready(contract_id):
    while True:
        c = requests.get(f"{API}/contracts/{contract_id}", headers=HEADERS).json()
        if c["processingStatus"] == "ready":
            return c
        if c["processingStatus"] == "failed":
            raise RuntimeError(c.get("processingError"))
        time.sleep(3)

wait_until_ready(contract["id"])

curl -X POST https://api.econtract.online/api/v1/contracts/$CONTRACT_ID/signing-links \
  -H "Authorization: Bearer $ECONTRACT_API_KEY"

const { data: links } = await fetch(`${API}/contracts/${contract.id}/signing-links`, {
  method: "POST",
  headers,
}).then((r) => r.json());

for (const link of links) {
  if (link.signingUrl) console.log(`${link.name} <${link.email}>: ${link.signingUrl}`);
}

links = requests.post(f"{API}/contracts/{contract['id']}/signing-links", headers=HEADERS).json()["data"]
for link in links:
    if link["signingUrl"]:
        print(f"{link['name']} <{link['email']}>: {link['signingUrl']}")

curl -o signed.pdf -D - \
  "https://api.econtract.online/api/v1/contracts/$CONTRACT_ID/document?version=signed" \
  -H "Authorization: Bearer $ECONTRACT_API_KEY"
# headers include X-Document-Version: signed and X-Document-Sha256

curl https://api.econtract.online/api/v1/contracts/$CONTRACT_ID/audit-trail \
  -H "Authorization: Bearer $ECONTRACT_API_KEY"

import { writeFile } from "node:fs/promises";

const doc = await fetch(`${API}/contracts/${contract.id}/document?version=signed`, { headers });
if (!doc.ok) throw new Error((await doc.json()).code); // DOCUMENT_NOT_SIGNED until completed
await writeFile("signed.pdf", Buffer.from(await doc.arrayBuffer()));

const trail = await fetch(`${API}/contracts/${contract.id}/audit-trail`, { headers }).then((r) => r.json());
console.log(trail.chain.valid, trail.documentSha256 === doc.headers.get("X-Document-Sha256"));

doc = requests.get(f"{API}/contracts/{contract['id']}/document", params={"version": "signed"}, headers=HEADERS)
doc.raise_for_status()  # 409 DOCUMENT_NOT_SIGNED until completed
with open("signed.pdf", "wb") as f:
    f.write(doc.content)

trail = requests.get(f"{API}/contracts/{contract['id']}/audit-trail", headers=HEADERS).json()
print(trail["chain"]["valid"], trail["documentSha256"] == doc.headers["X-Document-Sha256"])