Manage, Send and Sign Contracts in One Place

const organizationId = "your_org_id";
const token = "YOUR_TOKEN_HERE";

fetch(
  `https://api.enlivy.com/organizations/${organizationId}/contracts?page=1&limit=20` +
    // filters are optional and combinable
    `&direction=outbound&category=core` +
    // pass a q=... param instead of ids to run a full-text search
    `&include=contract_status,sender_user,receiver_user,contract_parties` +
    `&include_meta=navigation`,
  {
    method: "GET",
    headers: {
      Authorization: `Bearer ${token}`,
      "Content-Type": "application/json"
    }
  }
);

const organizationId = "your_org_id";
const contractId = "your_contract_id";
const token = "YOUR_TOKEN_HERE";

fetch(
  `https://api.enlivy.com/organizations/${organizationId}/contracts/${contractId}` +
    // available includes: organization, parent_contract, sender_user, receiver_user,
    // file, contract_status, contract_chapters, contract_parties, contract_prefix
    `?include=contract_chapters,contract_parties,contract_status`,
  {
    method: "GET",
    headers: {
      Authorization: `Bearer ${token}`,
      "Content-Type": "application/json"
    }
  }
);

const organizationId = "your_org_id";
const token = "YOUR_TOKEN_HERE";

fetch(`https://api.enlivy.com/organizations/${organizationId}/contracts`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${token}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    // core | amendment | addenda | supplement.
    // amendment/addenda/supplement REQUIRE organization_contract_id -> a "core" parent contract.
    category: "core",

    // internal  -> auto-numbered from a prefix (organization_contract_prefix_id required below)
    // uploaded  -> you supply `number`, and may set `signed_by_all_parties_at`
    source: "internal",

    direction: "outbound",         // outbound | inbound
    organization_sender_user_id: "org_user_sender_id",
    organization_receiver_user_id: "org_user_receiver_id",
    organization_contract_status_id: "contract_status_id",

    // required only for internal + core; omit it for any other source/category
    organization_contract_prefix_id: "contract_prefix_id",

    title: "Master Services Agreement",
    sub_title: "2026 Engagement",
    locale: "en",
    issued_at: "2026-07-03 09:00:00",
    ends_at: "2027-07-03 09:00:00",
    content_introduction: "This agreement is entered into between the parties below.",
    content_signature_disclaimer: "By signing, each party agrees to the terms above.",

    chapters: [
      { title: "Scope of Work",  content: "<p>The Provider will deliver…</p>", order: 1 },
      { title: "Payment Terms",  content: "<p>Fees are due within 14 days…</p>", order: 2 }
    ],

    parties: [
      {
        // party_type, party_country_code, first_name, last_name are required on every party
        party_type: "organization",          // organization | individual
        party_country_code: "RO",

        // organization parties additionally REQUIRE organization_name + organization_type
        organization_name: "Acme Studio SRL",
        organization_type: "srl",            // value comes from reference data

        first_name: "Jane",
        last_name: "Doe",
        role_in_organization: "Administrator",
        referenced_as_within_document: "the Provider",
        appears_as_party: true,
        is_signature_required: true,
        contact_email_address: "jane@acme.example",
        order: 0

        // country-specific `information` (person) and `organization_information` (company)
        // JSON blocks are also accepted; their shape is validated against the country schema.
      },
      {
        party_type: "individual",
        party_country_code: "RO",
        first_name: "John",
        last_name: "Smith",
        referenced_as_within_document: "the Client",
        appears_as_party: true,
        is_signature_required: true,
        contact_email_address: "john@example.com",
        order: 1
      }
    ]
  })
});

const organizationId = "your_org_id";
const contractId = "your_contract_id";
const token = "YOUR_TOKEN_HERE";

fetch(`https://api.enlivy.com/organizations/${organizationId}/contracts/${contractId}`, {
  method: "PUT",
  headers: {
    Authorization: `Bearer ${token}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    // partial update, only the fields you send are touched
    organization_contract_status_id: "next_status_id",
    sub_title: "2026 Engagement (revised)",
    ends_at: "2027-12-31 23:59:59"
  })
});

const organizationId = "your_org_id";
const contractId = "your_contract_id";
const token = "YOUR_TOKEN_HERE";

// returns a file stream, read it as a blob, not JSON
const pdf = await fetch(
  `https://api.enlivy.com/organizations/${organizationId}/contracts/${contractId}/download`,
  {
    method: "GET",
    headers: { Authorization: `Bearer ${token}` }
  }
).then((r) => r.blob());

const organizationId = "your_org_id";
const contractId = "your_contract_id";
const token = "YOUR_TOKEN_HERE";

// soft delete, restore via POST /contracts/restore/{contractId}
fetch(`https://api.enlivy.com/organizations/${organizationId}/contracts/${contractId}`, {
  method: "DELETE",
  headers: {
    Authorization: `Bearer ${token}`,
    "Content-Type": "application/json"
  }
});

const organizationId = "your_org_id";
const token = "YOUR_TOKEN_HERE";

fetch(
  `https://api.enlivy.com/organizations/${organizationId}/contract-statuses?page=1&limit=50`,
  {
    method: "GET",
    headers: {
      Authorization: `Bearer ${token}`,
      "Content-Type": "application/json"
    }
  }
);

const organizationId = "your_org_id";
const token = "YOUR_TOKEN_HERE";

fetch(`https://api.enlivy.com/organizations/${organizationId}/contract-statuses`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${token}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    // per-locale maps, not plain strings
    title_lang_map: { en: "Awaiting Signature", ro: "În așteptarea semnării" },
    description_lang_map: {
      en: "Sent to all parties for signing.",
      ro: "Trimis către toate părțile pentru semnare."
    },
    contract_state: "action_required", // draft | action_required | accepted | breach | terminated
    direction: "any",                  // inbound | outbound | any

    // order is unique per organization, pick a free slot,
    // or reorder existing stages via PUT /contract-statuses/reorder
    order: 3,
    rgba_color_code: "rgba(59, 130, 246, 1)"
  })
});

const organizationId = "your_org_id";
const token = "YOUR_TOKEN_HERE";

fetch(`https://api.enlivy.com/organizations/${organizationId}/contract-signatures`, {
  method: "POST",
  headers: {
    Authorization: `Bearer ${token}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    organization_contract_id: "contract_id",

    // one active session per party, organization_contract_party_id is unique
    organization_contract_party_id: "party_id",

    // user_flow  -> Enlivy hosts the signer experience (get the link via sign_session_url)
    // admin_panel -> you record the signature yourself and may send is_signed / signature_drawing / signed_contract
    signature_source: "user_flow",

    sign_session_signature_types: ["draw", "checkbox"],      // draw | checkbox | file_classic | file_electronic
    sign_session_required_confirmations: ["email", "legally_binding"], // email | phone | legally_binding
    expires_at: "2026-07-17 23:59:59"
  })
});

const organizationId = "your_org_id";
const signatureId = "your_signature_id";
const token = "YOUR_TOKEN_HERE";

fetch(
  `https://api.enlivy.com/organizations/${organizationId}/contract-signatures/${signatureId}/send`,
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${token}`,
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      method: "email",  // email | sms
      message: "Please review and sign the agreement by Friday."
    })
  }
);

const organizationId = "your_org_id";
const signatureId = "your_signature_id";
const token = "YOUR_TOKEN_HERE";

fetch(
  `https://api.enlivy.com/organizations/${organizationId}/contract-signatures/${signatureId}` +
    // sign_session_url returns the hosted link to give to the signer.
    // status is one of: pending | sent | completed | expired | void
    `?include=sign_session_url,organization_contract`,
  {
    method: "GET",
    headers: {
      Authorization: `Bearer ${token}`,
      "Content-Type": "application/json"
    }
  }
);

const organizationId = "your_org_id";
const token = "YOUR_TOKEN_HERE";

fetch(
  `https://api.enlivy.com/organizations/${organizationId}/contract-signatures` +
    // omit organization_contract_id to list sessions across every contract
    `?organization_contract_id=contract_id&include=sign_session_url`,
  {
    method: "GET",
    headers: {
      Authorization: `Bearer ${token}`,
      "Content-Type": "application/json"
    }
  }
);

const organizationId = "your_org_id";
const contractId = "your_contract_id";
const token = "YOUR_TOKEN_HERE";

// also available per session: /contract-signatures/{signatureId}/download-evidence
const evidence = await fetch(
  `https://api.enlivy.com/organizations/${organizationId}/contracts/${contractId}/download-evidence`,
  {
    method: "GET",
    headers: { Authorization: `Bearer ${token}` }
  }
).then((r) => r.blob());