Skip to main content
POST
Post Naics Prediction Request

Authorizations

X-API-Key
string
header
required

Headers

Idempotency-Key
string | null

An opaque key, ideally a UUID, that makes this request safe to retry. A second request with the same key, path, query and body answers with the resource the first one created, marked Idempotent-Replayed: true, instead of creating another; a sync request that finds it still running waits for it. The same key with a different request is refused with 422. Keys are scoped to your application and to this resource type, and are kept for the life of the resource.

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:

"7d25333a-2472-46fa-a469-0fc4822759cd"

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-10-29T05:44:47.891567"

idempotency_key
string | null

The Idempotency-Key header the request that created this resource carried, if any.

business_id
string<uuid> | null

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

Example:

"f697fb24-0487-495c-8819-1ef48e2469f6"

business_search_id
string<uuid> | null

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

Example:

"f81496d5-82cc-4227-beee-e523111835b6"

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"