Classifies a business into one industry code system per request (NAICS, SIC, workers comp, or general liability). Predictions are returned under a type-specific key (for example usa_naics_2022_prediction_hp or usa_sic_prediction_hp). Use responseConfig to control optional fields and prediction count. To request multiple code systems in one call, use POST /classification instead.
Base URLhttps://classification.relativity6.com
Authentication
Send your API key in the x-api-key header. Send your API key in this header on every request. Modern keys use the format r6-<keyId>.<secret>.
Request body
Field
Type
Required
Description
name
string
Required
Company name to classify.
state
string
Optional
US state or region. Improves match accuracy when provided.
address
string
Optional
Street address.
city
string
Optional
City.
zip
string
Optional
Postal or ZIP code.
country
string
Optional
Country.
predictionType
enum
Optional
Code system to return. Defaults to USA_NAICS_2017. See the prediction types guide for response key names.Default: USA_NAICS_2017USA_NAICS_2017 · USA_NAICS_2022 · R6_WORKERS_COMP · R6_GENERAL_LIABILITY · USA_SIC
searchIntelligence
enum
Optional
Research depth in balanced search mode. Defaults to low when omitted.low · medium · high
searchMode
enum
Optional
balanced runs web research before classifying; fast prioritizes lower latency.Default: balancedbalanced · fast
race
boolean
Optional
Optional performance setting for balanced mode. Defaults to true.Default: true
description
string
Required if descriptionOnly is true
Free-text description of the business (max 1000 characters).
descriptionOnly
boolean
Optional
When true, classifies from request fields and description without web research.Default: false
responseConfig
object
Optional
Controls prediction count and optional response fields.
numberOfPredictions
1 | 2
Optional
Number of ranked code predictions to return.Default: 2
includeExistenceCheck
boolean
Optional
Include business existence verification and supporting evidence.Default: true
includeDomainSearch
boolean
Optional
Include the inferred company website and confidence score.Default: true
includeKeywords
boolean
Optional
Include activity keywords derived from research.Default: true
includeBusinessDescription
boolean
Optional
Include a short AI-generated business description.Default: false
Response
Field
Type
Required
Description
usa_naics_2017_prediction_hp
object
Optional
Present when predictionType is USA_NAICS_2017 (also the default when omitted).
prediction_a
object
Required
Primary classification for the business.
code
string
Required
Industry code value.
title
string
Required
Official title for the code.
accuracy
number
Required
How confident the classification is for this code (0.10–0.95).
prediction_b
object
Optional
Alternate classification when numberOfPredictions is 2.
code
string
Required
Industry code value.
title
string
Required
Official title for the code.
accuracy
number
Required
How confident the classification is for this code.
usa_naics_2022_prediction_hp
object
Optional
Present when predictionType is USA_NAICS_2022.
prediction_a
object
Required
Primary classification.
code
string
Required
6-digit NAICS 2022 code.
title
string
Required
Official NAICS title.
accuracy
number
Required
Confidence score (0.10–0.95).
prediction_b
object
Optional
Alternate classification when numberOfPredictions is 2.
code
string
Required
6-digit NAICS 2022 code.
title
string
Required
Official NAICS title.
accuracy
number
Required
Confidence score (0.10–0.95).
r6_workers_comp_prediction_hp
object
Optional
Present when predictionType is R6_WORKERS_COMP.
r6_general_liability_prediction_hp
object
Optional
Present when predictionType is R6_GENERAL_LIABILITY.
usa_sic_prediction_hp
object
Optional
Present when predictionType is USA_SIC.
prediction_a
object
Required
Primary 4-digit SIC classification.
code
string
Required
4-digit SIC code.
title
string
Required
Official SIC title.
accuracy
number
Required
Confidence score (0.10–0.95).
prediction_b
object
Optional
Alternate classification when numberOfPredictions is 2.
code
string
Required
4-digit SIC code.
title
string
Required
Official SIC title.
accuracy
number
Required
Confidence score (0.10–0.95).
keywords
string[]
Optional
Activity keywords when includeKeywords is true.
company_website
[string, number]
Optional
Inferred domain and confidence when includeDomainSearch is true.
existence_check
object
Optional
Business existence check when includeExistenceCheck is true.
exists
boolean
Required
Whether the business appears to exist.
evidence_exist
array
Optional
Supporting references used for the existence determination.
business_description
string
Optional
Short business description when includeBusinessDescription is true.
responseId
string (UUID)
Required
Unique identifier for this response.
requestId
string
Required
Request identifier for correlation.
timestamp
string (ISO 8601)
Required
When the response was generated.
Response headers
X-Marvin2-Cache
Cache status for this request: HIT (served from cache) or MISS (computed fresh).
Errors
Status
Description
400
Invalid JSON or validation error (for example, descriptionOnly without description).
