Tariff Code Classification

Version v2
Classifications
CreateHSClassificationRequest
GetHSClassification
HSCodeValidationRequest
HSCodeVerificationRequest
NomenclatureChangeWebhook
WebhookCallback

DocumentUploadRequest

multipart/form-data body for the document-upload variant of this endpoint. Submit a PDF and/or image(s); the service reads them into classification object(s) and classifies them. At least one of pdf, images, text, imageUrl, or url must be supplied. The classification-intent fields (classificationType, classifications, countryOfDestination) are applied to every product extracted from the document(s). Files are validated for type, size (≤ 25 MB/file, ≤ 50 MB total, ≤ 10 files), page count (≤ 50), readability, encryption, and image quality before extraction.

This model is used in the following APIs:

Parameters
pdfOptional
string

A single PDF document to classify.

imagesOptional
array

One or more image files (PNG / JPG / JPEG). Repeat the field to send several.

textOptional
string

Raw product text/description (alternative or supplement to a file).

titleOptional
string

Optional product title hint.

imageUrlOptional
string

URL of a product image to read, instead of or in addition to an uploaded file.

urlOptional
string

URL of a product page to read.

countryOfExportOptional
string

ISO 3166-1 alpha-2 country-of-export hint. Applied to every extracted product, and required when classifications includes eccn — the per-item rule (COE_REQUIRED_FOR_ECCN) is evaluated against the extracted items, so an ECCN upload without it fails validation after extraction.

isExportOptional
boolean

When true, classify using export (Schedule B) codes.

classificationTypeOptional
string

Classification tier applied to every extracted product.

Enum: managed, autoPro, autoEssentials
classificationsOptional
string

Comma-separated classification activities applied to every extracted product — e.g. hsFull or hsFull,compliance. Allowed: hsFull, hs6, export, eccn, compliance, coo, premium. Including eccn additionally requires countryOfDestination and countryOfExport.

countryOfDestinationOptional
string

Comma-separated ISO 3166-1 alpha-2 destination country codes applied to every extracted product — e.g. US or US,CA. Required when classifications includes hsFull, hs6 or eccn.