Core & Core+

A v2 risk assessment is organized into categories — self-contained sections such as firmographics, business history, or OSHA.

There are two tiers:

1. Core — always runs. You do not send it as an option.
2. Core+ — optional priced modules. Pass their category ids in enabled_categories.

Every v2 organization can run every live module. There is no separate entitlement list on the request or the result. What you pay is the credit total for Core plus any Core+ modules on that job.

When a job completes, the poll payload puts the assessment under response. That object is large in production; this page documents shape, not full payloads.

response
├── metadata          request_id, version, generated_at, duration_ms, endpoint
├── entity            entity_id, snapshot_id, primary_name, is_new
├── summary           top-level executive summary (not inside categories)
├── categories        map of category id → result
│   └── <id>
│       ├── status
│       ├── overview    summary, risk_level, confidence
│       ├── data        category-specific fields
│       └── source_ids  pointers into response.sources
└── sources[]         bibliography (source_type: web | marvin2 | records)

summary is top-level. It is part of Core (summary is a Core id) but it is never nested under categories.summary.

Absent keys were not run. If categories.osha is missing, OSHA was not on this job. Do not treat a missing key as an empty company.

Status values you will see on live jobs:

Read overview.confidence and data per category. Categories run independently — one degraded section does not void the rest.

sources and source_ids: each category cites bibliography rows by id. source_type is web (open web), marvin2 (Relativity6 Data Source), or records (public records). There is no per-category embedded source list.

Overlaps to watch:

• Core government_filings is corporate registration and related filings. Core+ form_5500 and irs_990 are separate filing programs — they do not replace Core.
• Core property_overview is address verification. Core+ property_financials adds assessed value, tax, mortgage, and sale detail.
• Core owners_operators is the people section. Firmographics may still include a thin operator rollup.
• Core online_presence is domain, listings, and reviews. Core+ digital_risk is cyber / exposure posture.

Omit enabled_categories (or pass []) to run Core only. The Core assessment is charged on every POST /v2/risk job.

Industry classification is the Core category that currently has extra request options — see Configuration.

Core+ modules are optional. Add them on the first job with enabled_categories, or later with snapshot extend. Credit weights for live modules:

Full catalog of wire ids (including coming soon):

Core always runs, and Core has request options. Each Core+ module might have options of its own. Matching fields (state, website, address) are not category config, but they strongly affect which entity is assessed.

Matching the business

Send at least company_name. Add state (strongly recommended), website, and a street address when you have them.

Industry classification

Applies to Core industry_classification.

Industry codes follow the families you request. Unrequested families are omitted from the result.

OSHA

Applies when osha is in enabled_categories, and on snapshot extend for that module. Use osha.layer on submit and modules[].options.layer on extend.

Business risk flags

Applies when business_risk_flags is in enabled_categories.

Other live Core+ modules have no extra options today.

These records are not live. Do not send them in enabled_categories or snapshot extend.

To add OSHA and Form 5500 on the same submit:

Every v2 organization can request any live Core+ module. What you pay is the credit total for Core plus the modules on that job.

After the first snapshot, you can add one priced module at a time with snapshot extend instead of starting a new job.