REST API Documentation

v1

Programmatic access to manage rooms, exhibits, recordings, transcripts, registrations, and accounts on LiveLitigation.

Your domain:

Curl examples below will update to match.

Authentication

All API requests require an API key sent in a custom header. The header name depends on which API you are using:

Account API

x-account-key: YOUR_API_KEY

Your account API key is available under Host Settings → API Access within the LiveLitigation desktop client.

Manager API

x-manager-key: YOUR_MANAGER_KEY

Manager API keys are provided by your LiveLitigation administrator. Inactive or suspended accounts will receive 403 Forbidden.

Base URL

https://connect.livelitigation.com

All endpoint paths below are relative to this base URL. Use the domain input above to customize the examples for your account.

Error Responses

All errors return JSON with a human-readable message:

{ "error": "Human-readable error message" }
StatusMeaning
400Bad Request - missing or invalid parameters
401Unauthorized - missing API key
403Forbidden - invalid key, domain mismatch, or inactive account
404Not Found - resource doesn't exist or outside your scope
409Conflict - duplicate resource or constraint violation
429Too Many Requests - rate limit exceeded
500Internal Server Error

Pagination

List endpoints support limit and offset query parameters. Responses include a meta object:

{ "data": [...], "meta": { "total": 42, "limit": 20, "offset": 0 } }

Account API

The Account API lets you manage rooms, guests, exhibits, recordings, transcripts, and registrations within your own account. Authenticate with x-account-key.

Rooms

POST
/api/v1/account/roomsCreate a new room▸
GET
/api/v1/account/roomsList all rooms▸
GET
/api/v1/account/rooms/:roomIdGet a single room▸
PUT
/api/v1/account/rooms/:roomIdUpdate a room▸
DELETE
/api/v1/account/rooms/:roomIdDelete (disable) a room▸

Guests

DELETE
/api/v1/account/rooms/:roomId/guests/:emailRemove a verified guest▸

Exhibits

GET
/api/v1/account/rooms/:roomId/exhibitsList room exhibits▸

Recordings

GET
/api/v1/account/rooms/:roomId/recordingsList room recordings▸

Transcripts

GET
/api/v1/account/rooms/:roomId/transcriptsList room transcripts▸
POST
/api/v1/account/rooms/:roomId/transcripts/:transcriptId/summaryRequest AI transcript summary▸
GET
/api/v1/account/rooms/:roomId/transcripts/:transcriptId/summaryCheck AI summary status▸

All Assets

GET
/api/v1/account/rooms/:roomId/assetsList all room assets▸

Rate Limits

All endpoints have practical rate limits to ensure platform stability. Exceeding rate limits returns 429 Too Many Requests. If you encounter rate limiting during normal usage, please contact support.

Manager API

The Manager API is available exclusively to Platform-tier accounts. It provides programmatic control over account provisioning and management. Contact your LiveLitigation administrator to inquire about Platform-tier access.

Manage accounts under your domain scopes. Authenticate with x-manager-key.

Accounts

POST
/api/v1/manager/accountsCreate a new account▸
GET
/api/v1/manager/accountsList your accounts▸
GET
/api/v1/manager/accounts/:idGet a single account▸
PUT
/api/v1/manager/accounts/:idUpdate an account▸

Account Types

The type field on account creation determines the feature set and limits. This is enforced server-side and cannot be overridden.

TypeDescription
eSuiteFull-featured suite with video, exhibits, realtime, recording, chat, and more

The account type defines the feature set, maximum room users, video publisher limits, session duration, recording storage, and concurrent room limits.