R6
Relativity6
Getting Started

Overview

Relativity6 is an AI-powered underwriting intelligence platform that turns a company name into a complete risk picture in under two minutes.

What is Relativity6?

Relativity6 aggregates data from dozens of public and licensed sources — business registrations, OSHA records, litigation filings, health inspections, digital presence signals, and more — then synthesizes everything into a single Snapshot: a structured risk report your underwriting team can act on immediately.

Instead of spending 30-45 minutes manually researching a submission, your team gets a comprehensive view in about 90 seconds. Every data point is sourced and citable, so you can verify anything Marvin surfaces.

Key concepts

Snapshots

A Snapshot is a point-in-time risk intelligence report for a single business entity. It includes firmographic data, NAICS classification, ownership structure, regulatory history, litigation exposure, digital risk signals, and Marvin's synthesized risk narrative. Snapshots are immutable once generated — run a new one to get updated data.

Marvin

Marvin is Relativity6's AI copilot. He reads every data source, weighs the signals against your team's Risk Profile, and produces a plain-language synthesis with confidence-scored recommendations. Marvin also watches your monitored book overnight and flags changes — new litigation, OSHA violations, ownership transfers — so nothing slips through.

Risk profiles

A Risk Profile tells Marvin how your team underwrites. It includes the lines you write, industries you avoid, flags you want auto-surfaced, and severity thresholds. Think of it as a configuration file for Marvin's judgment. It's a team-level setting — everyone on your workspace shares the same profile.

Data sources

Every claim in a Snapshot is backed by one or more source providers. Click the source pill on any data point to see exactly where it came from — the provider name, the URL, and when the data was last refreshed. Relativity6 currently aggregates from 14+ providers across firmographic, regulatory, litigation, and digital risk categories.

Tip
Need help reading a Snapshot for the first time? Check the Reading a snapshot guide.

Your first five minutes

  1. Run a search — Click + New search in the sidebar. Enter a company name and state. Marvin starts building your Snapshot.
  2. Review the Snapshot — Scan the cards top-to-bottom: firmographics, risk flags, regulatory history, digital presence, and Marvin's synthesis.
  3. Check sources — On any card, click View Details and toggle Show sources to see every provider and URL behind the data.
  4. Leave feedback — If something looks wrong, use the menu on any card to flag it. The data team reviews same-day.
  5. Make a decision — When you're ready, use the Bind decision panel to record your outcome and attach notes.
What's next
Ready to dive deeper? Read Quickstart for a step-by-step walkthrough, or explore How snapshots work to understand the data pipeline.
Getting Started

Quickstart

You already know the problem. A submission lands, and you're copy-pasting across six systems for the next 45 minutes — hoping you don't miss the one thing that matters. Relativity6 collapses that into 90 seconds.

The underwriting bottleneck

Every commercial underwriter lives in the same loop: a broker sends a submission, and the clock starts. You need a complete risk picture — entity verification, OSHA history, litigation exposure, ownership structure, digital presence — and you need it before the broker places it elsewhere.

Today that means toggling between your AMS, LexisNexis, D&B, state licensing portals, Google, court records, and whatever else your line demands. Six or more systems, no shared context, no audit trail connecting them. The research is manual, the format is inconsistent, and the fear of missing a material fact never goes away.

The real cost
Missed material facts aren't just bad underwriting — they're career-ending. Regulatory exposure for a discoverable-but-undiscovered adverse event is the single highest-severity risk underwriters face.

What Relativity6 does differently

Relativity6 replaces the multi-system hunt with a single input: company name and state. From there, Marvin — our AI underwriting copilot — pulls from 14+ data providers simultaneously, resolves the entity, cross-references the signals, and delivers a structured Snapshot with every claim sourced and citable.

90-second Snapshots

What used to take 30–45 minutes of manual research is now a single search. Firmographics, NAICS, ownership, regulatory history, litigation, digital signals — assembled and synthesized automatically.

🔗

Every claim cited

No black boxes. Every data point links back to its source provider and URL. Click any source pill to verify exactly what Marvin found and when it was last refreshed.

🎯

Your appetite, your rules

Risk Profiles teach Marvin how your team underwrites — which lines you write, industries you avoid, flags you want surfaced. The AI scores against your criteria, not a generic model.

📋

Audit-ready by default

Every Snapshot is immutable and timestamped. Export a PDF that documents the data, the sources, and the decision — a defensible file that survives scrutiny.

Built for how underwriters actually work

Whether you're a high-volume desk writing small-business BOPs or a specialty underwriter digging into complex risks, the workflow is the same: search, review, decide. Relativity6 adapts to your segment:

You're optimizing for…Relativity6 gives you…
Speed — high-volume, small-premiumZero-question Snapshots that let you quote in minutes, not hours. Move through your queue without sacrificing diligence.
Defensibility — specialty / complex risksCore+ enrichment with OSHA, adverse media, and digital health signals. Every finding cited for audit trail.
Consistency — growing team / MGAStandardized risk memos across your entire desk. New hires produce the same quality output as your ten-year veterans.

Try it now

The fastest way to understand Relativity6 is to run a Snapshot yourself. Our Workbench demo is preloaded with sample data so you can explore the full experience — search, review a Snapshot, examine sources, and see how Marvin synthesizes risk signals into actionable intelligence.

Open the Workbench demo → No account required. Explore with sample data.

Your first Snapshot in three steps

  1. Search — Enter a company name and state. Marvin resolves the entity and begins pulling from all connected data providers. Results arrive in about 90 seconds.
  2. Review — Scan the Snapshot top-to-bottom: firmographics, risk flags, regulatory history, digital presence, and Marvin's plain-language synthesis. Every data point has a source pill you can click to verify.
  3. Decide — You have the complete picture. Quote, decline, or refer up — with a citable, exportable file backing your decision.
What's next
Ready to configure Marvin for your team's appetite? See Risk Profiles. Want to understand the data pipeline? Read How Snapshots work.
Getting Started

Pricing

Pricing is a conversation. We tailor our plans to your organization's specific needs, ensuring you get the right signal depth and features for your underwriting team.

How pricing works

Our pricing is built on two independent levers that scale with how your team actually grows:

Seats
How wide
Price scales linearly with team size. Add underwriters as you grow — no volume negotiations.
Signal depth
How deep
Core includes 6 baseline signal packs. Core+ adds 7 premium packs for complex risks. Enterprise adds custom feeds.
Why we don't meter Snapshots
Per-Snapshot pricing punishes the Zero-Question promise. The faster Marvin gets, the more Snapshots your team runs — we want to encourage that, not tax it. Unlimited Snapshots on every tier.

Plans

Core
Custom pricing
The instrument every commercial underwriter gets on day one. Verification, Zero-Question Snapshot, and defensibility audit.
  • Zero-Question Snapshot — verified entity + 6 baseline signal packs
  • Defensibility audit with cited sources
  • 1 custom risk profile per seat
  • PDF export with annotations
  • Marvin CoPilot — Zero-Question chat
  • Renewal reminders on saved entities
  • Premium signal packs (OSHA depth, litigation, adverse media)
  • Renewal Delta timeline
  • SSO, RBAC, SCIM
Enterprise
Customseat-banded
For carriers and MGAs running their entire book on Relativity6. Custom feeds, org-wide governance, and contractual SLAs.
  • Everything in Core+
  • Custom signal feeds (your claims data, loss runs, submission history)
  • Unlimited risk profiles, org-managed
  • SSO, RBAC, SCIM + audit-log export
  • Data residency options (US, EU)
  • Contractual latency SLA + uptime credits
  • Quarterly business review

Feature comparison

Capability Core Core+ Enterprise
Verification & Snapshot
Zero-Question Snapshot Priority SLA-backed
Baseline signal packs 6 packs 6 packs 6 packs
Premium signal packs All 7 7 + custom
Defensibility audit + export Org-wide
Renewal & monitoring
Renewal reminders
Renewal Delta (12-month timeline)
Mid-term monitoring alerts 25 / seat Unlimited
Team & governance
Custom risk profiles 1 / seat 3 / seat Unlimited
SSO, RBAC, SCIM
Data residency (US/EU)
Commercial
Contract type Annual, self-serve Annual, sales-assisted Multi-year, negotiated
Latency commitment Best-effort p95 < 30s Contractual SLA

Key numbers

What you can expect when your team is up and running:

<90s
Time to Snapshot
14+
Data providers
Snapshots / month
1 deal
Core+ pays for itself

Frequently asked questions

Can I switch between plans?
Yes. You can upgrade from Core to Core+ at any time — your billing is prorated for the remainder of the current period. Downgrades take effect at the next billing cycle. Enterprise contracts are custom and handled through your account manager.
Are there per-Snapshot or per-API-call charges?
No. Every plan includes unlimited Snapshots and API calls. We charge for seat count and signal-pack depth, not usage volume. The faster your team works, the more value you extract — with no metering penalty.
What happens when a Core user hits a premium signal?
Core users see every Core+ data row inside their Snapshot — but the premium rows appear locked with a blurred preview and an inline "Unlock with Core+" prompt. You always know what deeper signals are available for a given entity.
Is there a free trial?
We offer a 14-day trial on Core with full access to baseline signal packs. Core+ trial access is available for qualified teams — contact sales for details. Enterprise always starts with a scoping call.
What's included in the Sandbox environment?
The Sandbox mirrors production behavior but returns synthetic data. It's available on all plans at no additional cost. Use it for development, integration testing, and training new team members without consuming production tokens.
Do you offer volume discounts?
Core and Core+ prices are published and consistent. For teams larger than 25 seats, Enterprise pricing includes seat-band discounts negotiated based on commitment level and contract term.
Explore the Workbench demo → See how Snapshots, risk profiles, and Marvin work together — no signup required.
Snapshots

How snapshots work

Learn how Relativity6 builds a Snapshot — from entity resolution through data aggregation to Marvin's synthesis.

The Generation Process

When you request a snapshot (e.g., for "Thirty-One Jane LLC"), our system kicks off a series of concurrent processes:

  1. Entity Resolution: We resolve the input against our internal graph and public registries to confirm the exact legal entity.
  2. Data Aggregation: We pull live data from Secretary of State filings, real estate databases, footprint analysis, and digital presence APIs.
  3. Marvin Synthesis: Marvin, our proprietary AI, reads the raw data, resolves conflicting information (like mismatched DBAs), and writes the cohesive "Company Facts" prose you see at the top of the report.
  4. Risk Scoring: Data is passed through your configured Risk Profile to highlight red flags.

Caching & Freshness

By default, Snapshots are cached for 30 days to save you credits. If you need absolute real-time data, you can pass the force_refresh=true flag in your API call or click the refresh icon in the Workbench.

Snapshots

Understanding your report

A card-by-card walkthrough of everything in a Snapshot report.

1. Company Facts

The top section contains human-readable prose synthesized by Marvin. It provides a quick summary of what the business does, its history, and its physical footprint.

2. Risk Hero

A visual gradient that indicates the overall risk level of the entity based on your specific risk configuration. Green indicates low risk, while red indicates critical flags.

3. Intelligence Chips

Below the summary, you'll find interactive chips (e.g., Company registration, Property verification). Clicking these opens a drawer with the raw source data and confidence scores.

4. Core+ Modules

Locked chips with a star (★ Core+) represent premium data sources like Adverse Media or OSHA records. You can unlock these on-demand.

Snapshots

Data sources

A complete list of the 14+ data providers Relativity6 aggregates, what each covers, and how often data refreshes.

  • Government Registries: Direct integrations with all 50 US Secretary of State databases for active/inactive status and true legal names.
  • Digital Footprint: Web scraping, review aggregation (Yelp, Google), and social media presence mapping.
  • Property & Footprint: Satellite imagery APIs and municipal parcel data for property verification.
  • Compliance: Federal and state agency databases including OSHA, EPA, and labor boards.
Privacy First
We strictly adhere to data privacy regulations and only source publicly available or licensed B2B intelligence.
Marvin AI

What is Marvin

Meet Marvin — your AI underwriting copilot that reads every data source and synthesizes risk narratives.

Marvin is the intelligence layer of Relativity6. Unlike traditional data providers that return raw JSON blobs filled with null values, Marvin acts as an autonomous research assistant.

Think of Marvin as an incredibly fast junior analyst. When given a company name, Marvin doesn't just query a database; it actively searches the web, reads the company's "About Us" page, cross-references it with state registries, and writes a cohesive summary.

Marvin AI

How Marvin works

Under the hood: how Marvin processes data, applies your risk profile, and produces confidence-scored recommendations.

The Agent Architecture

  • The Researcher: Browses the live web and scrapes relevant text.
  • The Verifier: Cross-checks the scraped text against trusted databases (like state registries) to assign a Confidence Score.
  • The Synthesizer: Writes the final, human-readable prose that appears in your Snapshot.

You can interact directly with Marvin in the Workbench by opening a notebook and asking questions like "Did this company ever operate under a different name?"

Risk Profiles

Risk profiles overview

How risk profiles shape Marvin's analysis and what each configuration option controls.

Not all businesses view risk the same way. A tech startup has a different risk appetite than a commercial property insurer. Risk Profiles allow you to define exactly what constitutes a "red flag".

By default, Relativity6 provides an "Out of the box" profile, but you can create unlimited custom profiles to match your underwriting guidelines.

Risk Profiles

Configuration options

Reference for every setting available in the risk profile editor.

Available Signal Adjustments:

  • Registration Status: Flag companies that are inactive or have lapsed in the last 12 months.
  • NAICS Mismatch: Flag when the self-reported industry code drastically differs from Marvin's classified industry.
  • Adverse Media (Core+): Flag negative news mentions involving fraud, litigation, or leadership changes.
  • Web Presence: Flag companies with no active website or empty domains.
Admin & Management

Team management

Invite teammates, manage roles, and configure seat allocation for your workspace.

Relativity6 supports Role-Based Access Control (RBAC) to ensure your data stays secure.

  • Admin: Full access to billing, API keys, and team invites.
  • Manager: Can create and edit Risk Profiles and view team usage.
  • Analyst: Can generate Snapshots and chat with Marvin, but cannot change global settings.
Admin & Management

Usage & billing

Track token consumption, snapshot counts, and manage your subscription plan.

Navigate to Settings > Billing to view your current usage. The dashboard provides a visual breakdown of your Credit consumption over the current billing cycle.

You can set up alerts to notify you when your team has consumed 80%, 90%, and 100% of your monthly allotment.

Admin & Management

API keys

Generate, rotate, and manage API keys for programmatic access to Relativity6.

Relativity6 provides two environments: Sandbox and Production.

To generate an API key:

  1. Go to Settings > Developers.
  2. Click Generate New Key.
  3. Give your key a descriptive name.
  4. Store the secret key securely. It will not be shown again.

All API requests must include the key in the header: Authorization: Bearer YOUR_KEY.

Resources

Frequently asked questions

Answers to the most common questions about Relativity6, Marvin, and your workspace.

This article is coming soon
We're writing this guide right now. Check back shortly.
Resources

Privacy & Security

How Relativity6 handles data privacy, SOC 2 compliance, and security practices.

This article is coming soon
We're writing this guide right now. Check back shortly.
Resources

System Status

Current platform status, uptime history, and incident reports.

This article is coming soon
We're writing this guide right now. Check back shortly.
Resources

Changelog

What's new in Relativity6 — feature releases, data source additions, and platform updates.

This article is coming soon
We're writing this guide right now. Check back shortly.
Getting Started

Your first snapshot

A hands-on walkthrough: from company search to bind decision in under five minutes.

1

Run a search

Use the global search bar in the top navigation to find the company you want to underwrite. Marvin will cross-reference state registries in real time.

Tupelo Honey Hospitality
2

Review the Risk Hero

Once the Snapshot completes, look at the Risk Hero card. It provides a synthesized verdict (Low, Medium, High) based on your team's custom Risk Profile.

Risk level
Medium
Confidence
89%
3

Verify before bind

Marvin will compile a specific checklist of items you need to manually verify before binding the policy. Click the circles to mark them complete.

Look up the NLRB case status.
Case 10-CA-170109 is on file but the outcome wasn't in the synthesis. Go to nlrb.gov, search the case number, and check the status page.
Risk Profiles · How-to

Set up your risk profile for an automotive broker

Configure Marvin to underwrite like your team does — focused on auto dealers, repair shops, and fleet operations.

Prerequisites
You need Editor or Admin role on your workspace. Risk profiles are team-level settings — changes apply to everyone's snapshots.

Step 1: Define the lines you write

Open Settings → Risk Profile → Lines you write. For an automotive broker, you'll typically select:

  • Garage liability — covers auto dealers, repair shops, service stations
  • Commercial auto — fleet operations, delivery vehicles, dealer plates
  • Garagekeepers legal liability — customer vehicles in your care, custody, control
  • Property — dealership buildings, parts inventory, specialized equipment

Marvin uses these selections to weight risk signals. A DUI conviction on an owner matters more when you're writing garage liability than general property.

Step 2: Set industry preferences

Under Industries to avoid, add any you don't want to see in your queue:

  • Salvage / junk yards — environmental exposure, title-washing risk
  • Motorcycle-only dealers — different risk profile, often specialty market
  • Heavy equipment rental — crosses into inland marine territory

Under Industries to prioritize, flag your sweet spot:

  • Franchised new car dealers — stable, manufacturer-backed
  • Used car dealers (5+ years) — established operations with track record
  • Fleet maintenance shops — recurring revenue, lower liability ceiling

Step 3: Configure auto-surface flags

These are the signals Marvin will always call out prominently:

  • DMV complaints pattern — 3+ consumer complaints in 24 months
  • EPA / environmental violation — paint booths, fluid disposal, soil contamination
  • Dealer license suspension — any state action against the dealer bond
  • Owner DUI / reckless driving — personal driving record of principals
  • OSHA serious-tier (24mo) — lift failures, spray booth ventilation, fire suppression
  • Lemon law litigation (active) — indicates potential customer dispute patterns
Important
Auto-surface flags are always shown — even if the overall Snapshot would otherwise score green. These are the signals your team never wants to miss.

Step 4: Set severity behavior

  • Standard — Marvin scores normally and recommends based on your line thresholds
  • Surcharge on pattern — if 2+ flags appear in the same category, Marvin automatically bumps severity one tier
  • Refer at material — any flag scored "material" or above triggers an automatic referral recommendation

For most automotive brokers, Surcharge on pattern is the right default.

Step 5: Verify and save

Before saving, run a test Snapshot against a known account in your book. Compare Marvin's output to your team's last manual review of the same account.

Risk Profiles · How-to

Set up for hospitality

Configure your risk profile for hotels, restaurants, bars, and event venues.

Hospitality businesses (restaurants, hotels, event venues) have unique exposures compared to standard retail. Setting up your risk profile correctly ensures Marvin flags the right signals.

Lines you write

  • General Liability: The core coverage. Focus heavily on premises liability, slip-and-falls, and crowd control.
  • Liquor Liability: A massive exposure if they serve alcohol. Look for liquor license violations.
  • Property: Kitchen fires, water damage from guest rooms.

Signals to auto-surface

  • Health Department Violations: A critical leading indicator of operational sloppiness.
  • Liquor License Suspensions: Direct threat to revenue and massive liability exposure.
  • Labor Disputes: Hospitality often faces wage-and-hour or discrimination claims.
Risk Profiles · How-to

Set up for retail

Configure your risk profile for retail stores, e-commerce, and consumer goods businesses.

Retail operations vary wildly from small boutiques to massive big-box chains, but the core underwriting principles remain consistent.

Focus Areas

  • Premises Liability: Slip-and-fall is the most common claim. Marvin will scan reviews for mentions of unsafe conditions.
  • Product Liability: Do they manufacture or just distribute? Are they importing goods directly from overseas?
  • Crime & Security: Look for crime scores and mentions of theft or inadequate security.
Marvin Tip
Tell Marvin to prioritize reading Google Reviews for mentions of "security", "dark parking lot", or "unsafe" when assessing retail risks.
Snapshots · How-to

Reading a snapshot

A card-by-card guide to understanding what's in your Snapshot and how to act on it.

1

The Snapshot Header

The header shows you the company name, website, NAICS code, and Marvin's confidence rating. You can also export to PDF or share a link here.

Tupelo Honey Hospitality
tupelohoneycafe.com · Full-Service Restaurants (722511)
Export PDF
2

Company Facts

This section outlines immutable data about the business. It contains simple chips you can hover over to see exactly which sources contributed to that fact.

Est. 2000 Private 26 locations
3

Top Findings

Marvin extracts the most critical signals—both positive and negative. Click the View Sources toggle to see exactly where each insight was pulled from.

Snapshots · How-to

Flagging bad data

How to report incorrect data points, stale information, or broken source links.

Our data is incredibly accurate, but no system is perfect. When you spot an issue, flagging it directly in the Workbench routes it to our Data Engineering team.

How to flag an issue

  1. Hover over any data point (a fact, a finding, or a source).
  2. Click the small flag icon that appears on the right side.
  3. Select the reason (e.g., "Stale information", "Incorrect entity", "Broken link").
  4. (Optional) Add a brief note explaining why you believe it's incorrect.
Response Time
Flagged data issues are typically investigated by our data team within 24 hours. The model is then retrained to prevent similar errors.
Snapshots · How-to

Exporting PDF reports

Generate branded PDF exports of your Snapshots for carrier submissions and compliance files.

Need to share a Snapshot with an underwriter or a broker who doesn't have a Relativity6 account? You can generate a clean, white-labeled PDF report in one click.

Exporting options

Click the Export button at the top right of the Snapshot. You can choose:

  • Full Report: Includes everything, including the complete timeline and all sources. (Usually 4-6 pages).
  • Summary Only: Just the Company Facts, Risk Hero, and Top Findings. (Usually 1 page).
  • Custom: Select exactly which sections to include.
Marvin · How-to

Using Marvin for triage

Let Marvin pre-screen your submission queue and surface the accounts that need human attention.

Marvin is your AI CoPilot, living right inside the Snapshot. You can chat with Marvin to ask specific questions about the data.

Marvin
I noticed a health department violation from 2022. I dug into the source document and found it was for improper temperature storage. However, they scored a 98/A on their follow-up inspection 30 days later. This appears to be an isolated incident rather than a systemic issue.

When to use Triage

Use Marvin to summarize long lists of reviews, extract specific dates from OSHA violations, or compare the company's risk profile against your specific underwriting guidelines.

Marvin · How-to

Custom prompts

Write custom instructions for Marvin to tailor his analysis to your specific workflow.

This article is coming soon
We're writing this guide right now. Check back shortly.
Integrations · How-to

Connecting to your AMS

Integrate Relativity6 with your Agency Management System for automated submission intake.

This article is coming soon
We're writing this guide right now. Check back shortly.
API Reference

Introduction

The Relativity6 API lets you programmatically search for businesses, generate Snapshots, and manage risk profiles from your own platform.

This article is coming soon
We're writing this guide right now. Check back shortly.
API Reference

Authentication

Every API request requires a Bearer token. This page covers how to get your key, authenticate requests, and handle token errors.

Getting your API key

Navigate to Settings → API keys in the Workbench. Click Generate new key and give it a descriptive name. Your key will be shown once — copy it immediately and store it in your secrets manager.

Security
API keys carry the same permissions as the user who created them. Never commit keys to version control or embed them in client-side code.

Bearer token format

Include your API key in the Authorization header of every request. Keys are prefixed with r6_live_ for production and r6_test_ for sandbox environments.

Error responses

Authentication errors return standard HTTP status codes:

StatusMeaningWhat to do
401 Missing or invalid API key Check the Authorization header format
403 Insufficient permissions Generate a new key with write access
429 Rate limit exceeded Retry after Retry-After header value

Environments

EnvironmentBase URLKey prefix
Production https://api.relativity6.ai/v1 r6_live_
Sandbox https://sandbox.relativity6.ai/v1 r6_test_

Sandbox mirrors production behavior but returns synthetic data. Use it for development and integration testing without consuming tokens.

Authentication
HTTP Header
Authorization: Bearer r6_live_abc123...your_key
Example request
cURL
curl --request POST \
  --url https://api.relativity6.ai/v1/search \
  --header 'Authorization: Bearer r6_live_abc123' \
  --header 'Content-Type: application/json' \
  --data '{
    "company_name": "Mountain States Hospitality LLC",
    "state": "CO"
  }'
Python
import requests

resp = requests.post(
    "https://api.relativity6.ai/v1/search",
    headers={
        "Authorization": "Bearer r6_live_abc123"
    },
    json={
        "company_name": "Mountain States Hospitality LLC",
        "state": "CO"
    }
)
snapshot = resp.json()
print(snapshot["id"], snapshot["status"])
Response · 200
JSON
{
  "id": "snap_8f3k2j1m",
  "status": "processing",
  "company_name": "Mountain States Hospitality LLC",
  "state": "CO",
  "created_at": "2026-05-11T14:32:00Z",
  "estimated_completion": 90
}
Search API

Search for a Business

Look up a business entity by name and state, then automatically initiate Snapshot generation with Marvin's full data enrichment pipeline.

POST /v1/search

Authorizations

Authorization string header required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
ParameterTypeDescription
company_name required string Legal or DBA name of the business to search for. Marvin performs entity resolution, so partial matches and common abbreviations are handled.
state required string Two-letter US state code (e.g. "CO", "NY"). Used for entity disambiguation and state-specific regulatory lookups.
address optional string Street address of the primary business location. Improves entity resolution accuracy for common business names.
naics_code optional string 6-digit NAICS code. If provided, Marvin skips classification inference and uses this code for industry-specific data pulls.
risk_profile_id optional string ID of a custom Risk Profile to apply. Defaults to the team's active profile. Controls which flags Marvin surfaces and how severity is scored.
webhook_url optional string URL to receive a snapshot.completed event when the Snapshot finishes processing. Must be HTTPS.

Response

Returns a Snapshot object in processing status. Typical completion time is 60–90 seconds. Poll GET /v1/snapshot/{id} or use a webhook to receive the completed result.

FieldTypeDescription
id string Unique Snapshot identifier, prefixed with snap_.
status string One of processing, completed, or failed.
company_name string Resolved legal entity name after Marvin's entity resolution.
state string Two-letter state code as submitted.
created_at string ISO 8601 timestamp of when the Snapshot was initiated.
estimated_completion integer Estimated seconds until the Snapshot is ready.

Error codes

StatusCodeDescription
400 invalid_request Missing company_name or state, or invalid state code.
401 unauthorized Missing or invalid API key.
429 rate_limited Too many requests. Retry after the Retry-After header value.
Search for a Business
cURL
curl --request POST \
  --url https://api.relativity6.ai/v1/search \
  --header 'Authorization: Bearer r6_live_abc123' \
  --header 'Content-Type: application/json' \
  --data '{
    "company_name": "Mountain States Hospitality LLC",
    "state": "CO"
  }'
Python
import requests

resp = requests.post(
    "https://api.relativity6.ai/v1/search",
    headers={
        "Authorization": "Bearer r6_live_abc123"
    },
    json={
        "company_name": "Mountain States Hospitality LLC",
        "state": "CO",
        "risk_profile_id": "rp_default"
    }
)

snapshot = resp.json()
print(f"Snapshot {snapshot['id']}: {snapshot['status']}")
Response · 200
JSON
{
  "id": "snap_8f3k2j1m",
  "object": "snapshot",
  "status": "processing",
  "company_name": "Mountain States Hospitality LLC",
  "state": "CO",
  "naics_code": "721110",
  "naics_description": "Hotels and Motels",
  "risk_profile_id": "rp_default",
  "created_at": "2026-05-11T14:32:00Z",
  "estimated_completion": 90,
  "sources_queued": 14,
  "webhook_url": null
}
Error · 400
JSON
{
  "error": {
    "code": "invalid_request",
    "message": "state is required",
    "param": "state"
  }
}
Snapshot API

GET /v1/snapshot/{id}

Retrieve a completed Snapshot by ID.

This article is coming soon
We're writing this guide right now. Check back shortly.
Snapshot API

POST /v1/snapshot

Generate a new Snapshot for a business entity.

This article is coming soon
We're writing this guide right now. Check back shortly.
Risk Profile API

GET /v1/risk-profile

Retrieve the current risk profile configuration.

This article is coming soon
We're writing this guide right now. Check back shortly.
Risk Profile API

PUT /v1/risk-profile

Update your workspace's risk profile configuration.

This article is coming soon
We're writing this guide right now. Check back shortly.
Webhooks

Webhooks overview

Receive real-time notifications when Snapshots complete, flags change, or monitored entities update.

This article is coming soon
We're writing this guide right now. Check back shortly.
Webhooks

Event types

Reference for all webhook event types, payloads, and retry behavior.

This article is coming soon
We're writing this guide right now. Check back shortly.
Account

Rate limits

Default rate limits, usage tiers, and how to request increases.

This article is coming soon
We're writing this guide right now. Check back shortly.
Account

SDKs & Libraries

Official client libraries for Python, Node.js, and Go.

This article is coming soon
We're writing this guide right now. Check back shortly.