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:

"fb8688d3-c62d-4982-9c0a-70a196b97d16"

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-11-11T04:02:02.598990"

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:

"2110a912-c576-4723-9f14-ee5b3283c3d2"

business_search_id
string<uuid> | null

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

Example:

"0f536f3a-8b37-4f6f-8852-98a377f64b63"

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"