Skip to main content
POST
Post Naics Prediction Request

Authorizations

X-API-Key
string
header
required

Headers

Prefer
string | null

Request execution preference (RFC 7240). Use respond-async for asynchronous execution, wait=N to specify a synchronous timeout hint in seconds, or priority=low to route the task to the low-priority queue.

Example:

"respond-async"

Body

application/json

Request model for ad-hoc NAICS code prediction.

name
string
required

The name of the business.

address
string
required

The address of the business.

alternative_names
string[] | null

Alternative names for the business (e.g., DBA names)

Maximum array length: 10
officer_names
string[] | null

List of business officers' names.

website
string | null

The website URL associated with the business.

Maximum string length: 2083
phone_number
string | null

A phone number associated with the business.

email
string | null

An email address associated with the business.

reference_id
string | null

An optional reference ID to associate with the request.

Maximum string length: 128

Response

Response

id
string<uuid>
required

Unique identifier for the NAICS prediction request.

Example:

"25c3910b-5423-46fb-bbe2-63b9a639f034"

state
enum<string>
required

The status of the NAICS prediction request

Available options:
PENDING,
EXECUTING,
COMPLETED,
FAILED,
CANCELLED
Examples:

"COMPLETED"

"FAILED"

created_at
string<date-time>
required

The date and time when the NAICS prediction request was created.

Example:

"2026-08-31T10:31:07.747451"

business_id
string<uuid> | null

The ID of the business for which the NAICS code was predicted.

Example:

"4099bc48-3ad9-46c2-99a2-c864a6ac0208"

business_search_id
string<uuid> | null

The ID of the business search from which this NAICS prediction request originated.

Example:

"98e11f83-e0a0-4ef9-8001-d39be1c00f25"

predicted_naics
PredictedNaicsResponse (v1) · object | null

The predicted NAICS code(s) for the business entity.

error
string | null

Any errors that occurred during the NAICS prediction request.

reference_id
string | null

An optional reference ID associated with this request, inherited from the parent search.

Example:

"Search1234"