Supergood | Timeslips API

Supergood | Timeslips API

Programmatically access clients, matters, time and expense slips, pre-bill review, and invoicing from Sage Timeslips with a stable REST API. Supergood builds and operates production-grade, unofficial Timeslips integrations so your team can automate time & billing workflows without heavy custom engineering.

Plain English: Timeslips is timekeeping and billing software for law firms. It helps attorneys and staff capture time and expenses, apply rates and billing arrangements, review pre-bills, issue invoices (including LEDES e-billing formats), record payments and trust transfers, and report on profitability. An unofficial API lets you pull clients, matters, rates, slips, pre-bill status, invoices, and payments—and push new time entries, write-downs, approvals, trust movements, and invoice delivery.

For a tech company integrating with Timeslips—especially a legaltech startup fitting into an iManage workflow—this means you can sync matter and client rosters from Timeslips to your platform, auto-capture time from iManage document/email activity into slips, drive pre-bill approvals from your case or workflow tool, generate LEDES-compliant invoices, and publish PDFs back into the appropriate iManage workspace. You can build features like activity-based time capture, matter-level profitability dashboards, automated write-down rules, and unified billing queues that sit alongside the DMS your lawyers already use.

What is Timeslips?

Timeslips (https://www.timeslips.com/) is a time and billing platform widely used by law firms and professional services organizations. It supports granular time and expense capture, flexible rate management, pre-bill review workflows, invoicing (including LEDES formats), payments, and trust/retainer accounting.

Core product areas include:

  • Time & Expense Capture (slips, activity/task codes, timers)
  • Rates & Billing Arrangements (hourly, flat fee, contingency, custom rates by timekeeper/matter)
  • Pre-Bill Review & Adjustments (write-downs, narratives, approvals)
  • Invoicing & E-Billing (PDF and LEDES 1998B exports, email delivery)
  • Payments & Trust/Retainer (receipts, trust transfers, allocations)
  • Reporting & Analytics (realization, utilization, WIP, A/R, profitability)
  • Integrations (accounting systems, document management workflows)

Common data entities:

  • Clients (organizations/individuals, billing profile, contacts)
  • Matters/Projects (client, responsible attorney, billing arrangement, rates, status)
  • Timekeepers (attorneys/staff, roles, default rates)
  • Slips (time and expense entries with codes, rates, amounts, billable flags)
  • Activity & Task Codes (standardized classification for work performed)
  • Billing Cycles & Pre-Bills (grouped WIP for review and approval)
  • Invoices (finalized bills, formats, delivery status)
  • Payments & Trust Accounts (receipts, transfers, balances)
  • Users/Roles (permissions, approval rights)
  • Audit Events (who changed what, when)

The Timeslips Integration Challenge

Law firms rely on Timeslips daily, but turning its desktop- and portal-centric workflows into API-driven automation presents challenges:

  • Data modeling complexity: Rate hierarchies (timekeeper/matter/client), billing arrangements, and write-downs must be applied consistently during calculation.
  • Pre-bill lifecycle: WIP collection, narrative edits, approvals, and adjustments span hours to days and require asynchronous handling and auditability.
  • E-billing formats: LEDES field mapping, task/activity code sets, and client-specific requirements need normalization to avoid rejection.
  • Trust & payments: Retainer balances, allocations to invoices, and split payments need accurate sequencing and safeguards.
  • DMS alignment: Mapping matters and documents between Timeslips and iManage workspaces requires reliable identifiers and cross-system references.
  • Authentication & sessions: Headless automation must maintain secure sessions and respect role-based permissions and approvals.

How Supergood Creates Timeslips APIs

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

  • Handles username/password and customer-managed credentials securely
  • Maintains session continuity with automated refresh and change detection
  • Normalizes clients, matters, slips, pre-bills, and invoices so you can integrate once and rely on consistent schemas
  • Aligns with customer entitlements and role-based permissions to ensure compliant access
  • Supports high-volume operations (bulk slip ingestion, billing cycles) with polling or webhooks for long-running jobs
  • Generates LEDES outputs alongside PDFs and captures delivery status

Use Cases

iManage-Driven Time Capture

  • Create time slips from document and email activity in iManage (open, edit, send events)
  • Apply matter-level rates and activity/task codes automatically
  • Tag slips with iManage workspace/document references for auditability

Pre-Bill Review & Approval Sync

  • Generate pre-bills for selected matters on a schedule
  • Sync pre-bill queues and approval states to your workflow tool
  • Apply write-downs and narrative edits programmatically and capture rationale

LEDES & Invoice Delivery

  • Finalize approved pre-bills into invoices across clients
  • Export PDF and LEDES 1998B files and deliver via email
  • Attach finalized invoices back into the appropriate iManage workspace

Trust & Payment Automation

  • Record payments and allocate retainer balances to open invoices
  • Enforce sequencing rules and prevent over-application
  • Feed A/R and realization metrics into your analytics layer

Available Endpoints

Authentication

POST /sessions: Establish a session using credentials. Supergood manages secure login and maintains a short-lived auth token for API operations.

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>"
  }'

Example response

{
  "authToken": "eyJhbGciOi...",
  "expiresIn": 3600,
  "user": {
    "id": "u_tslp_91e2a4",
    "name": "Billing Administrator",
    "entitlements": ["clients", "matters", "slips", "billing", "invoices"]
  }
}

POST /sessions/refresh: Refresh an existing token to keep sessions uninterrupted.

Matters

GET /matters: List matters with filters for client, status, and update windows.

Query parameters

  • clientId: string
  • status: open | closed | on_hold
  • updatedFrom, updatedTo: ISO 8601 timestamps
  • page, pageSize: integers for pagination

Example response

{
  "items": [
    {
      "matterId": "mtr_002813",
      "clientId": "cl_48102",
      "name": "Acme v. Northstar",
      "status": "open",
      "openDate": "2025-09-15",
      "billingArrangement": {"type": "hourly", "defaultRate": 325.0},
      "responsibleTimekeeper": {"id": "tk_0007", "name": "J. Martinez"},
      "iManageWorkspaceId": "IW-ACME-000123",
      "tags": ["litigation", "priority"]
    }
  ],
  "page": 1,
  "pageSize": 50,
  "total": 1
}

Time Slips

POST /slips/time: Create a time slip (time entry) for a matter with activity/task codes and billable flags.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/slips/time \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "externalId": "imanage-evt-77321",
    "clientId": "cl_48102",
    "matterId": "mtr_002813",
    "timekeeperId": "tk_0007",
    "date": "2026-02-19",
    "durationMinutes": 42,
    "activityCode": "L110",
    "taskCode": "BILL_PREP",
    "rate": 325.0,
    "billable": true,
    "description": "Review and revise motion; email to client",
    "referenceDocument": {
      "source": "imanage",
      "workspaceId": "IW-ACME-000123",
      "documentId": "DOC-8841"
    },
    "tags": ["dms_capture", "email"]
  }'

Example response

{
  "slipId": "slp_t_9a10c7",
  "status": "unbilled",
  "amount": 227.5,
  "createdAt": "2026-02-19T15:33:27Z"
}

Billing Pre-Bills

POST /billing/prebills: Generate pre-bills for one or more matters over a date range.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/billing/prebills \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "matterIds": ["mtr_002813", "mtr_002901"],
    "periodStart": "2026-01-01",
    "periodEnd": "2026-01-31",
    "includeExpenses": true,
    "groupBy": "matter",
    "applyWriteDowns": false
  }'

Example response

{
  "batchId": "bb_2026_01_31_A",
  "prebills": [
    {
      "prebillId": "pb_78410",
      "matterId": "mtr_002813",
      "totalHours": 19.4,
      "fees": 6310.0,
      "expenses": 85.0,
      "adjustments": 0.0,
      "status": "pending_review",
      "generatedAt": "2026-02-01T09:10:02Z"
    }
  ]
}

Invoices

POST /invoices/finalize: Finalize approved pre-bills into invoices and optionally deliver outputs.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/invoices/finalize \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "prebillIds": ["pb_78410"],
    "invoiceDate": "2026-02-02",
    "delivery": {
      "email": {"to": ["[email protected]"], "from": "[email protected]"},
      "attachToIManage": true
    },
    "outputFormat": ["pdf", "ledes1998b"]
  }'

Example response

{
  "invoices": [
    {
      "invoiceId": "inv_991204",
      "number": "2026-000181",
      "clientId": "cl_48102",
      "matterId": "mtr_002813",
      "invoiceDate": "2026-02-02",
      "total": 6395.0,
      "balanceDue": 6395.0,
      "pdfUrl": "https://files.supergood.ai/tslp/inv_991204.pdf",
      "ledesUrl": "https://files.supergood.ai/tslp/inv_991204.ledes",
      "sentAt": "2026-02-02T14:22:11Z",
      "iManageAttachment": {
        "workspaceId": "IW-ACME-000123",
        "documentId": "INV-2026-000181"
      }
    }
  ]
}

Get full API Specs →


Technical Specifications

  • Authentication: Username/password with support for service accounts or customer-managed credentials; sessions refreshed automatically
  • Response format: JSON with consistent resource schemas and pagination across modules
  • Rate limits: Tuned for firm-wide throughput while honoring customer entitlements and usage controls
  • Session management: Automatic reauth and session rotation with health checks
  • Data freshness: Near real-time retrieval of matters, slips, pre-bills, invoices, and payments
  • Security: Encrypted transport, scoped tokens, and audit logging; respects Timeslips role-based permissions and approvals
  • Webhooks: Optional asynchronous delivery for long-running workflows (e.g., billing batch generation, invoice delivery status)
  • E-billing: LEDES 1998B export support with configurable task/activity mappings

Performance Characteristics

  • Latency: Sub-second responses for list/detail queries under normal load; batch pre-bill generation reflects underlying platform behavior
  • Throughput: Designed for high-volume slip ingestion and billing cycle 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 Timeslips adapter tailored to your workflows, iManage mapping, and entitlements.

  1. Deploy with Monitoring

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

Schedule Integration Call →


Frequently Asked Questions

Q: Which Timeslips modules can this integration cover?

Supergood supports workflows commonly used for legal billing, including Clients & Matters, Time & Expense Slips, Billing Cycles & Pre-Bills, Invoices & LEDES Exports, Payments & Trust, and Reporting/Audit, subject to your licensing and entitlements. We scope coverage during integration assessment.

Q: How do you align Timeslips data with iManage workspaces?

We support mapping by client/matter identifiers and can store iManage workspace and document references on slips, pre-bills, and invoices. Attachments (e.g., PDF invoices) can be published back to the correct iManage workspace for unified matter files.

Q: Do you support pre-bill review and approvals?

Yes. We can generate pre-bills, synchronize queues and statuses, apply write-downs and narrative edits, and capture approvals with normalized audit records. Long-running operations are handled via polling or webhooks.

Q: Can you generate LEDES files?

Yes. We produce LEDES 1998B alongside PDF invoices and support configurable mappings for activity/task codes, timekeeper IDs, and client requirements to minimize rejection risk.

Q: How are rates and billing arrangements handled?

We apply the platform’s rate hierarchy (timekeeper/matter/client) and billing arrangement (hourly, flat, contingency) consistently, preserving raw calculations while exposing normalized totals and adjustments.

Q: Do you support trust and payment allocations?

Yes. We can record payments, allocate trust balances to invoices, and enforce sequencing rules to prevent over-application, with complete audit trails.


iManage API — Sync matter workspaces and document-based time capture alongside Timeslips


Ready to automate your Timeslips workflows?

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

Get Started →

Read more