Classifies a business into multiple code systems in one request. Toggle NAICS, SIC, MCC, and GL independently with include flags. For a single code system per call, use POST /marvin2 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
NAICS code set when includeNAICS is true.Default: USA_NAICS_2017USA_NAICS_2017 · USA_NAICS_2022
searchIntelligence
enum
Optional
Research depth. Defaults to low when omitted.low · medium · high
includeNAICS
boolean
Optional
Return hierarchical NAICS predictions under codes.naics.Default: true
includeSIC
boolean
Optional
Return SIC predictions under codes.sic.Default: false
includeMCC
boolean
Optional
Return MCC predictions under codes.mcc.Default: false
includeGL
boolean
Optional
Return ISO CGL general liability predictions under codes.gl.Default: false
NAICSOptions
object
Optional
Options when includeNAICS is true.
numberOfPredictions
number
Optional
Number of ranked NAICS predictions to return.Default: 2
predictionLevels
number[]
Optional
NAICS digit levels to include for each prediction (for example 2, 4, and 6).Default: [6]
SICOptions
object
Optional
Options when includeSIC is true.
numberOfPredictions
number
Optional
Number of ranked SIC predictions to return.Default: 2
MCCOptions
object
Optional
Options when includeMCC is true.
numberOfPredictions
number
Optional
Number of ranked MCC predictions to return.Default: 2
GLOptions
object
Optional
Options when includeGL is true.
numberOfPredictions
1 | 2
Optional
Number of ranked GL predictions to return.Default: 2
Response
Field
Type
Required
Description
codes
object
Required
Predictions grouped by code system. Arrays are empty when the matching include flag is false.
naics
NAICSPrediction[]
Required
Hierarchical NAICS predictions when includeNAICS is true.
predictionNumber
number
Required
Rank of this prediction (1 = primary).
codes
object[]
Required
Codes at each requested NAICS level.
code
string
Required
Industry code value.
title
string
Required
Official title for the code.
confidence
number
Required
Confidence for this code level (0.10–0.95).
level
number
Required
NAICS digit level (2, 4, or 6).
sic
SICPrediction[]
Required
SIC predictions when includeSIC is true.
mcc
MCCPrediction[]
Required
MCC predictions when includeMCC is true.
gl
GLPrediction[]
Required
5-digit ISO CGL predictions when includeGL is true.
keywords
string[]
Required
Activity keywords derived from research (uppercase).
companyInfo
object
Required
Company existence and website signals from research.
website
string
Required
Inferred primary domain.
websiteConfidence
number
Required
Confidence in the inferred website.
exists
boolean
Required
Whether supporting evidence was found.
evidences
string[]
Required
Source URLs used during research.
request
object
Required
Echo of the parsed request body.
responseId
string
Required
Unique identifier for this response.
timestamp
string (ISO 8601)
Required
When the response was generated.
executionTime
number
Required
Handler execution time in milliseconds.
requestId
string
Optional
Request identifier for correlation when provided by the client.
Response headers
X-Marvin2-Cache
Cache status for this request: HIT (served from cache) or MISS (computed fresh).
Errors
Status
Description
400
Invalid JSON, validation error, or no code types requested (set at least one of includeNAICS, includeSIC, includeMCC, or includeGL).
