Relativity API
Relativity is an AI-powered legal data platform whose flagship RelativityOne handles e-discovery, legal hold, review, and production workloads for law firms, corporations, and government agencies. An unofficial API lets you programmatically pull workspaces, documents, fields, searches, productions, and legal holds—and push updates like document imports, review coding, and production sets back into Relativity.
What is Relativity?
Relativity is an AI-powered legal data software company whose flagship platform, RelativityOne, helps legal teams organize complex data, uncover what matters most, and act with confidence. Law firms, corporations, and government agencies use Relativity for e-discovery, legal hold, early case assessment, investigations, contract review, and data breach response—collecting from sources like Microsoft 365, Google Workspace, and Slack, then processing, reviewing, and producing documents inside a single cloud workspace.
Core product areas include:
- RelativityOne (cloud e-discovery: legal hold, collection, processing, review, production, early case assessment)
- Relativity aiR (generative AI: aiR for Review, aiR for Privilege, aiR for Case Strategy, aiR for Data Breach Response)
- Review Center (customizable review queues and workflows)
- RelativityOne Government (FedRAMP-authorized variant for public-sector agencies)
- Relativity App Hub and Relativity MCP (custom apps and AI-agent connectivity)
Common data entities:
- Workspaces, Matters, Clients, Users, Groups
- Documents, Images, Native files, Metadata, Fields
- Saved Searches, Search Indexes, Conditions, Views
- Productions, Production Sets, Markups, Redactions
- Legal Holds, Custodians, Collections, Preservation Notices
- Relativity Dynamic Objects (RDOs), Coding Decisions, Batches, Tags
The Relativity Integration Challenge
Legal teams run case-defining workloads on Relativity daily, but turning workspace- and review-driven workflows into API-driven automation is non-trivial:
- Per-workspace customization: Fields, layouts, coding panes, and RDOs are configured per matter—generic integrations break across workspaces and tenants
- Object Manager indirection: Querying documents, fields, and RDOs requires resolving Artifact IDs, ObjectType integers, and condition syntax rather than simple resource paths
- Import/Export pipeline complexity: Bulk document, image, and RDO loads operate on load files and staged workspace locations, not single REST writes
- Authentication and partner gates: SSO, OAuth, and MFA are standard in legal environments, and full platform access can sit behind RelativityOne partner and entitlement controls
- Versioned API surface: Endpoint coverage and behavior differ across RelativityOne releases and the FedRAMP-authorized Government variant
- Chain-of-custody and audit requirements: Productions, redactions, and coding decisions demand precise, defensible audit trails
How Supergood Creates Relativity APIs
Supergood reverse-engineers authenticated browser flows and Relativity's Object Manager, Import/Export, and workspace services to deliver a resilient API layer for your Relativity environment—across RelativityOne and Government deployments.
- Handles SSO, OAuth, and MFA (SMS, email, TOTP) securely in a managed session
- Resolves Artifact IDs, ObjectType integers, and condition syntax so you query documents and RDOs by name
- Normalizes responses across Workspaces, Documents, Searches, Productions, and Legal Holds so you integrate once and rely on consistent objects
- Aligns with workspace-specific field configurations and entitlements to ensure compliant, defensible access
Use Relativity with AI agents: Relativity MCP Server →
Getting Started
- Schedule Integration Assessment
Book a 30-minute session to confirm your workspaces, fields, and authentication model.
- Supergood Generates and Validates Your API
We deliver a hardened Relativity adapter tailored to your workspace configuration and entitlements.
- Deploy with Monitoring
Go live with continuous monitoring and automatic adjustments as Relativity evolves.
API Endpoints
Authentication
/authenticateAuthenticate to a Relativity environment using SSO, OAuth, or MFA and obtain a session token for downstream calls.
Workspaces
/workspacesList workspaces (matters) with filters for client, status, and creation date across the Relativity instance.
Documents
/documentsQuery documents, fields, and metadata within a workspace using saved searches and condition filters via Object Manager.
Documents
/import_documentsImport documents, images, natives, and Relativity Dynamic Objects into a workspace from load files via the Import service.
Productions
/productionsRetrieve production sets, markups, and redactions with status and date-range filters.
Legal Holds
/create_legal_holdCreate a legal hold, assign custodians, and issue preservation notices for a matter.
Use Cases
Sync e-discovery documents and metadata into a warehouse
- Pull documents, fields, and coding decisions from review workspaces into a single warehouse - Stream search results and batch status to downstream analytics and reporting tools - Reconcile custodian and collection records across matters for unified case 360
Automate document import and review coding
- Push documents, images, and RDOs into a workspace from upstream collection tools via load files - Apply coding decisions and tags programmatically without manual review-pane clicks - Route privilege and responsiveness calls to downstream QC and case-strategy workflows
Orchestrate productions and redactions
- Pull production sets, markups, and redactions for delivery tracking and chain-of-custody logging - Trigger production generation and validate Bates ranges before export - Surface production errors and stamping issues to case-management workflows
Keep legal hold and custodian data in sync
- Create legal holds and issue preservation notices when a matter is opened - Pull custodian acknowledgement and collection status for compliance reporting - Trigger downstream HR and IT workflows when custodian or hold scope changes
Technical Specifications
Authentication
SSO, OAuth, and MFA (SMS, email, TOTP) handled in a managed session
Connectivity
Authenticated browser flows plus Relativity Object Manager, Import/Export, and Workspace REST services where exposed
Response format
Normalized JSON across Workspace, Document, Search, Production, and Legal Hold objects
Rate limits
Adaptive throttling tuned to your RelativityOne tenant to avoid platform-side limits
Session management
Automatic session refresh, MFA replay handling, and credential rotation
Data freshness
Near real-time pulls for documents, searches, and productions with optional scheduled batch syncs
Security
Encrypted credential vault, scoped access tokens, SOC 2-aligned controls, and audit logging; FedRAMP-aware for Government tenants
Webhooks
Event-style callbacks for document import completion, production status, and legal hold acknowledgements
Latency
Sub-second reads on cached entities; multi-second writes when importing documents and generating productions
Throughput
Horizontally scaled workers sized to large-volume document and metadata loads
Reliability
Retry, backoff, and idempotency keys for imports, coding updates, and production transactions
Adaptation
Continuous monitoring of RelativityOne releases, Object Manager version changes, and workspace configuration drift
Frequently asked questions
Yes. Supergood adapts to either deployment model. For RelativityOne we work against your cloud tenant; for Relativity Server we operate against the same authenticated Object Manager and workspace surfaces, with network configuration tuned to your environment.
Each workspace is profiled against its configured fields, layouts, and Relativity Dynamic Objects. Supergood resolves Artifact IDs and ObjectType integers so you query by name, preserving workspace-specific schemas rather than forcing a generic one.
Yes. Supergood drives the Import service to load documents, images, natives, and RDOs from load files, and can apply coding decisions, tags, and batch assignments programmatically across review workflows.
Yes. Supergood operates against the Government tenant's authenticated surfaces with FedRAMP-aware controls, keeping access compliant for public-sector matters.
Production sets, markups, and redactions are exposed through the normalized API with defensible chain-of-custody logging, so every read and write is captured for audit and discovery purposes.