Import Existing Cases with Polling

Import cases you're already tracking and poll for status updates.


🎯 Overview

📌 TL;DR

Import existing cases with known handler firms into Lexamica, then poll for status updates and settlements. Same functionality as webhooks, but you pull updates on your schedule.

This guide is for you if:

  • You have existing referral relationships to track in Lexamica

  • You already know which firm is handling each case

  • You can't receive webhooks or prefer batch processing

For real-time webhooks instead, see Import Existing Cases with Webhooks


📖 Key Terms

Term
Definition

Existing Case

A case already being handled, imported for tracking

Partner Firm ID

The Lexamica ID of the firm handling the case

Stored Event

An event record stored for polling retrieval


⚙️ Architecture


📋 Prerequisites

Credentials:

Infrastructure:

Foundational Docs:


💡 Step-by-Step Implementation

Step 1: Create Your Case Mapping

Same mapping as the webhook version:

Step 2: Create Stored Event Subscriptions

Step 3: Import Cases

Same endpoint as the webhook version:

Step 4: Poll for Updates

Query stored events to get updates and settlements.


🔧 Complete Code Example


📋 Events You'll Receive

Event
When
Payload

Case Update Made

Handler posts update

title, content, case_id

Case Stage Changed

Case moves stages

new stage, case_id

Case Settlement

Settlement starts

settlement details


❓ FAQ

❓ "How often should I poll?"

Use Case
Interval

Daily reports

Once per day

Regular tracking

Every 15-30 minutes

Near real-time

Every 5 minutes

For existing cases, updates typically aren't urgent—daily or hourly polling is usually sufficient.


❓ "Can I import many cases at once?"

📝 Full Answer: Yes. Loop through your cases:


➡️ Next Steps


Last updated: January 2026

Last updated