POST/v1/business/risk
Business risk
Returns a business risk assessment for a company, including firmographics, filings, digital presence, adverse media, risk flags, and an executive summary. Which sections appear depends on your account configuration and any categories you request.
Base URLhttps://api.relativity6.com
Request body
| Field | Type | Required | Description |
|---|
| company_name | string | Required | Legal or trade name of the business. |
| domain | string | Optional | Primary website domain (for example, acmecorp.com). |
| address | string | Optional | Street address. |
| city | string | Optional | City. |
| state | string | Optional | State or region code. |
| zip | string | Optional | Postal or ZIP code. |
| country | string | Optional | Country code (for example, US). |
| categories | string[] | Optional | Response sections to run, intersected with your account configuration. Use reviews for public review and rating data. You may also request onlinePresence or publicReviews directly when those sections are enabled for your organization.firmographic · publicFilings · digitalAssetHealth · corporateStability · riskAssessment · summary · propertyInsights · adverseMedia · reviews |
| category_filter | string[] | Optional | Limit which flag groups from your risk profile are evaluated. Applies only to the riskAssessment section. |
| flag_filter | string[] | Optional | Limit which named flags from your risk profile are evaluated. Applies only to the riskAssessment section. |
| chain_fulfillment | boolean | Optional | Request a deeper multi-pass assessment when true.Default: false |
| max_rounds | number | Optional | Maximum assessment passes when chain_fulfillment is true. |
| timeout_seconds | number | Optional | Requested processing time limit in seconds. A platform maximum still applies. |
| confidence_threshold | number | Optional | Minimum confidence score (0–1) for a field to be included in the response. |
| showMetadata | boolean | Optional | Include additional diagnostic fields when enabled for your account. |
| bypass_cache | boolean | Optional | Return a fresh assessment instead of a previously cached result. |
Response
| Field | Type | Required | Description |
|---|
| request | object | Required | Echo of the submitted company identifiers and processing time. |
| company_name | string | Required | Company name from the request. | | timestamp | string (ISO 8601) | Required | When the assessment was processed. |
|
| categoryAccess | object | Required | Which response sections were requested, allowed for your account, and actually returned. |
| requested | string[] | Required | Sections named in the request, if any. | | entitled | string[] | Required | Sections enabled for your organization. | | effective | string[] | Required | Sections included in this response. |
|
| company | object | Required | Business risk data organized by section. |
| firmographic | object | Optional | Legal identity, location, and scale estimates. | | legal_name | DataPoint<string> | Optional | Registered or commonly used legal name, with confidence and sources. | | employee_count | DataPoint<range> | Optional | Estimated employee count range, with confidence and sources. | | annual_revenue | DataPoint<range> | Optional | Estimated annual revenue range, with confidence and sources. |
| | onlinePresence | object | Optional | Website, social presence, and broader digital footprint. | | publicReviews | object | Optional | Structured public review and rating data. | | publicFilings | object | Optional | Government and corporate registry filings. | | adverseMedia | object | Optional | Adverse media findings and supporting references. | | digitalAssetHealth | object | Optional | Website security, technology, and digital risk signals. | | corporateStability | object | Optional | Corporate history, longevity, and stability indicators. | | riskAssessment | object | Optional | Risk flags and profile evaluation for the business. | | summary | object | Optional | Executive summary of the assessment. | | businessDescription | string | Optional | Plain-language description of what the business does. | | riskVerdict | string | Optional | Overall risk verdict for underwriting review. |
| | propertyInsights | object | Optional | Property and co-tenant insights when included in your account. |
|
| verifications | object | Required | How your submitted inputs matched the resolved business record. |
| execution | object | Required | How long the assessment took and how it was run. |
| mode | 'fast' | 'chained' | Required | fast for a single pass; chained for a deeper multi-pass run. | | rounds | number | Required | Number of assessment passes completed. | | providersExecuted | array | Required | Data sources that contributed to this response, with source references. | | totalLatency | number | Required | Total processing time in milliseconds. | | postProcessing | object | Optional | Status of summary generation when the summary section was requested. |
|
| quality | object | Required | Coverage and verification metrics for the returned data. |
| completenessScore | number | Required | Share of expected fields populated, from 0 to 1. | | verifiedFields | number | Required | Count of fields that passed verification. | | totalFields | number | Required | Total fields evaluated for completeness. |
|
