Sirion

Supergood | Sirion API

Alex Klarfeld

Alex Klarfeld

— 6 min read
Supergood | Sirion API

Programmatically access contracts, counterparties, obligations, approvals, and document links from Sirion with a stable REST API. Supergood builds and operates production-grade, unofficial Sirion integrations so your team can automate CLM workflows—especially alongside iManage—without heavy custom engineering.

Plain English: Sirion is contract lifecycle management software used by sophisticated in-house legal teams to author, negotiate, approve, sign, store, and manage obligations for buy-side and sell-side contracts. It centralizes templates and clauses, coordinates redlines and approvals in Word, tracks obligations and renewals, and provides AI to extract metadata from third‑party paper.

For a tech company integrating with Sirion, this means you can pull normalized contract records, obligations, and approval states; push new contracts or amendments; link and sync documents stored in iManage; and automate renewal/notice workflows. You can build features like matter-centric contract dashboards inside your app, auto-file executed agreements into iManage workspaces, obligation reminders with evidence capture, and cross-system reporting aligned to ERP/CRM data.

What is Sirion?

Sirion (https://www.sirionlabs.com) is an AI-powered Contract Lifecycle Management (CLM) platform that streamlines contract authoring, negotiation, execution, repository management, obligation tracking, and supplier performance.

Core product areas include:

  • Authoring & Templates (clause library, playbooks, fallback logic, Microsoft Word add-in)
  • Negotiation & Approvals (redlines, version control, routing, e-sign orchestration)
  • Repository & Search (central contract repository, metadata, document storage)
  • AI & Intake (third-party paper ingestion, OCR, metadata and clause extraction)
  • Obligations, SLAs & Renewals (milestones, notices, performance tracking)
  • Counterparty & Relationship Management (suppliers, customers, contacts)
  • Reporting & Audit (dashboards, audit history, exports)

Common data entities:

  • Contracts (master, NDA, MSA, SOW, order forms, amendments)
  • Counterparties (suppliers, customers, legal entities, contacts)
  • Clauses & Templates (library objects, playbooks)
  • Approvals (steps, assignments, decisions, timestamps)
  • Documents & Versions (Word drafts, executed PDFs, attachments)
  • Obligations & Milestones (type, owner, due date, status, evidence)
  • Signatures (DocuSign/Adobe Sign envelopes, status)
  • Users/Roles (legal, procurement, business owners)
  • Audit Events (who did what and when, before/after values)

The Sirion Integration Challenge

Legal teams rely on Sirion daily, but turning portal-centric contract work into API-driven automation—especially when documents live in iManage—introduces complexity:

  • Cross-system versioning: Word redlines and iManage document versions need to map cleanly to Sirion contract versions and negotiation states
  • Third-party paper ingestion: AI/OCR extraction runs asynchronously and must be polled and correlated back to the right contract
  • Approvals & routing: Multi-step approval chains, conditional routing, and reassignments require reliable, idempotent updates
  • Access control: Legal, procurement, and business units often work in segregated folders with granular permissions
  • SSO & MFA: Enterprise authentication (e.g., Azure AD/Okta) complicates headless automation
  • Repository alignment: Deciding which system (Sirion vs iManage) is the system of record for documents requires metadata and linkage discipline
  • Obligation lifecycle: Due dates, renewals, and notices span months/years and demand robust scheduling and webhook patterns
  • Configuration drift: Custom fields, templates, and clause libraries vary by tenant and evolve over time

How Supergood Creates Sirion APIs

Supergood reverse-engineers authenticated browser flows and network interactions to deliver a resilient API endpoint layer for your Sirion tenant.

  • Handles username/password, SSO/OAuth, and MFA securely; maintains session continuity with automatic refresh
  • Normalizes contracts, counterparties, approvals, obligations, and documents into consistent schemas
  • Maps iManage workspace/doc/version identifiers to Sirion records so repositories stay in sync
  • Supports long-running AI extraction and ingestion jobs with polling or webhooks and id correlation
  • Aligns with role-based permissions, folders, and entitlements to ensure compliant access
  • Implements idempotency, retries, and backoff for reliable updates at scale

Use Cases

Contract Intake & Authoring

  • Push new contracts from your app or iManage workspace events
  • Pre-populate metadata from CRM/ERP and clause playbooks
  • Route for legal review and approval, then e-sign

Negotiation & Approvals

  • Sync negotiation status and approver assignments into your case or matter system
  • Post decisions with rationales; capture audit data automatically
  • Trigger downstream actions (e.g., provisioning) on execution

Obligations & Renewal Tracking

  • Subscribe to webhooks for upcoming obligations and auto-create tasks in your tool
  • Mark obligations complete with evidence, notes, and links to source docs
  • Automate renewal notices and approvals based on contract terms

Document & iManage Sync

  • Link a Sirion contract to an iManage workspace and document version
  • Ingest third-party paper stored in iManage, run AI extraction, and update metadata
  • Auto-file executed PDFs back into the correct iManage matter or folder

Available Endpoints

Authentication

POST /sessions: Establish a session using credentials. Supergood manages MFA and SSO/OAuth when enabled. Returns a short-lived auth token maintained by the platform.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/sessions \
  --header 'Authorization: Basic <Base64 encoded token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "username": "[email protected]",
    "password": "<password>",
    "mfa": { "type": "totp", "code": "123456" }
  }'

Example response

{
  "authToken": "eyJhbGciOi...",
  "expiresIn": 3600,
  "user": {
    "id": "u_sir_41f2c9",
    "name": "Senior Counsel",
    "entitlements": ["contracts", "counterparties", "approvals", "obligations"]
  }
}

Contracts

POST /contracts: Create or update a contract and optionally associate an iManage document as the source file.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/contracts \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "externalId": "ctr_2026_0149",
    "title": "Master Services Agreement - ACME",
    "type": "MSA",
    "lifecycleState": "draft",
    "source": "third_party",
    "counterpartyId": "cp_acme_001",
    "ownerUserId": "u_sir_41f2c9",
    "effectiveDate": null,
    "endDate": null,
    "renewal": {"type": "manual", "noticeDays": 60},
    "value": {"currency": "USD", "amount": 2500000},
    "governingLaw": "NY",
    "jurisdiction": "US",
    "riskTier": "medium",
    "tags": ["strategic", "it-services"],
    "imanage": {
      "workspaceId": "WS-98765",
      "documentId": "D-124578",
      "version": 3,
      "library": "NY-Legal",
      "url": "https://work.yourfirm.com/imanage/WS-98765/docs/D-124578?v=3"
    }
  }'

Example response

{
  "contractId": "ctr_e3b219",
  "lifecycleState": "draft",
  "imanageLinked": true,
  "createdAt": "2026-02-20T10:18:44Z"
}

Counterparties

POST /counterparties: Create or update a counterparty (supplier or customer) with identifiers and contacts.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/counterparties \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "externalId": "acme_inc",
    "type": "organization",
    "legalName": "ACME, Inc.",
    "registrationNumber": "DE-9823412",
    "taxId": "US99-1234567",
    "country": "US",
    "duns": "001234567",
    "addresses": [
      {"line1": "123 Market St", "city": "San Francisco", "region": "CA", "postalCode": "94105", "country": "US"}
    ],
    "contacts": [
      {"name": "Jane Doe", "email": "[email protected]", "role": "Legal"}
    ],
    "riskRating": "medium"
  }'

Example response

{
  "counterpartyId": "cp_acme_001",
  "createdAt": "2026-02-20T10:21:01Z"
}

Obligations

GET /obligations: List obligations and milestones with filters for status, due windows, type, and contract.

Query parameters

  • status: open | in_progress | completed | waived
  • type: deliverable | payment | sla | notice | renewal
  • contractId: string
  • ownerUserId: string
  • dueFrom, dueTo: ISO 8601 timestamps
  • severity: low | medium | high
  • page, pageSize: integers for pagination

Example response

{
  "items": [
    {
      "obligationId": "obl_7f21a0",
      "contractId": "ctr_e3b219",
      "title": "Provide quarterly performance report",
      "type": "deliverable",
      "dueDate": "2026-03-31",
      "status": "open",
      "severity": "medium",
      "assignedTo": {"userId": "u_ops_102", "name": "Vendor Manager"},
      "evidence": [],
      "updatedAt": "2026-02-20T10:22:44Z"
    }
  ],
  "page": 1,
  "pageSize": 50,
  "total": 1
}

Document Linking (iManage)

POST /contracts/{contractId}/documents/link-imanage: Link an existing iManage document/version to a Sirion contract and optionally ingest metadata via AI extraction.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/contracts/ctr_e3b219/documents/link-imanage \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "workspaceId": "WS-98765",
    "documentId": "D-124578",
    "version": 4,
    "library": "NY-Legal",
    "url": "https://work.yourfirm.com/imanage/WS-98765/docs/D-124578?v=4",
    "ingest": {"enabled": true, "extractFields": ["effectiveDate", "endDate", "autoRenewal", "counterparty.legalName", "governingLaw"]}
  }'

Example response

{
  "contractId": "ctr_e3b219",
  "imanageLinked": true,
  "ingestionJob": {"jobId": "ing_9912aa", "status": "queued"}
}

Get full API Specs →

Technical Specifications

  • Authentication: Username/password with MFA and SSO/OAuth (e.g., Azure AD/Okta) where enabled; supports service accounts or customer-managed credentials
  • Response format: JSON with consistent resource schemas and pagination across modules
  • Rate limits: Tuned for enterprise throughput while honoring entitlements and usage controls
  • Session management: Automatic reauth and cookie/session rotation with health checks
  • Data freshness: Near real-time retrieval of contracts, counterparties, obligations, approvals, and document links
  • Security: Encrypted transport, scoped tokens, and audit logging; respects Sirion role-based permissions and folder access
  • Webhooks: Optional async delivery for long-running jobs (AI ingestion) and time-based events (obligations due, renewals)

Performance Characteristics

  • Latency: Sub-second responses for list/detail queries under normal load; ingestion completion times reflect underlying platform behavior
  • Throughput: Designed for high-volume contract intake, counterparty sync, and obligation queue synchronization
  • Reliability: Retry logic, backoff, and idempotency keys minimize duplicates and support at-least-once processing
  • Adaptation: Continuous monitoring for UI/API changes with rapid adapter updates

Getting Started

  1. Schedule Integration Assessment

Book a 30-minute session to confirm your modules, licensing, and authentication model.

  1. Supergood Builds and Validates Your API

We deliver a hardened Sirion adapter tailored to your workflows, iManage setup, and entitlements.

  1. Deploy with Monitoring

Go live with continuous monitoring and automatic adjustments as Sirion evolves.

Schedule Integration Call →

Frequently Asked Questions

Q: Which Sirion modules can this integration cover?

Supergood supports workflows commonly used for CLM, including Repository (contracts, documents), Authoring & Templates (metadata, clauses), Negotiation & Approvals (versions, routing), Obligations & Renewals (milestones, notices), and Reporting/Audit (exports), subject to your licensing and entitlements.

Q: How are MFA and SSO handled for automation?

We support username/password + MFA (SMS, email, TOTP) and can operate behind SSO/OAuth (e.g., Azure AD, Okta). Sessions are refreshed automatically with secure challenge handling and monitoring for session expiry.

Q: Do you support third-party paper ingestion and AI extraction?

Yes. We can ingest documents (including those stored in iManage), trigger Sirion’s AI/OCR extraction, poll job status, and write normalized metadata back to the contract record with full audit.

Q: How do you map iManage workspaces and versions to Sirion?

We store workspace, document, and version identifiers alongside the Sirion contract and track version-to-version lineage. You can designate iManage as the source of truth for documents while Sirion remains the source of truth for metadata and obligations.

Q: Can we attach evidence and maintain an audit trail for obligations and approvals?

Yes. We support uploading evidence via signed uploads or linking to iManage files, capturing rationale, approver, and timestamps with immutable audit records.

iManage API - Connect iManage Work document workflows to your apps with Supergood

Ready to automate your Sirion workflows?

Supergood can have your Sirion integration live in days with no ongoing engineering maintenance.

Get Started →

Read more